Balance

The /v1/account/balance endpoint retrieves the balance of your seller account.

HTTP Request

GET /v1/account/balance

Authorization

Required, see Authentication.

Arguments

Parameter	Type	Required	Description
currency	string	Optional	The currency of the amounts (default EUR).

Response

Field	Description
currency	The currency of the amounts.
current	Your current balance.
pending	Money of your sales that the payment provider hasn't settled yet. It is added to current once it is settled.
held	The sale amounts of sold trade-protected items. They are held until the trade protection has ended and then added to current automatically, see How does Steam's trade protection affect skin trading?.
updated_at	When the balance was updated last (Unix timestamp).

A 400 with a validation_error is returned if you don't have a seller account yet.

Example Request

JavaScript

balance.mjs

const params = new URLSearchParams({
  currency: 'EUR',
});

const response = await fetch(`https://api.skinport.com/v1/account/balance?${params}`, {
  headers: {
    Authorization: 'Basic <Base64_Encoded_String>',
    'Accept-Encoding': 'br',
  },
});

const data = await response.json();
console.log(data);

Python

balance.py

# pip install requests brotli  # brotli is needed to decode 'br' responses
import requests

params = {
    'currency': 'EUR',
}

response = requests.get(
    'https://api.skinport.com/v1/account/balance',
    params=params,
    auth=('MY_CLIENT_ID', 'MY_CLIENT_SECRET'),  # requests builds the Basic header
    headers={'Accept-Encoding': 'br'},
)

data = response.json()
print(data)

cURL

curl --compressed -u 'MY_CLIENT_ID:MY_CLIENT_SECRET' -H 'Accept-Encoding: br' \
  'https://api.skinport.com/v1/account/balance?currency=EUR'

Example Response

console.log(data)

{
    "data": {
        "currency": "EUR",
        "current": 125.4,
        "pending": 0,
        "held": 38.12,
        "updated_at": 1793760000
    }
}