Skip to main content

Balance

Endpoint

GET /balance

Parameters

ParameterTypeRequiredDescription
currency_namestringYesCurrency name (e.g., USDT).

Headers

HeaderTypeRequiredDescription
session-tokenstringYesAuthorization token.
api-keystringYesAPI key for user authentication.

Note: You must provide either session-token or api-key in the headers for authentication.

Response

JSON Array containing a single object


Response Fields

FieldTypeDescription
ustringUser ID.
cstringCurrency name (e.g., ETH, USDT).
tstringTotal balance.
astringAvailable balance.
lstringLast updated timestamp (in milliseconds).

Example Usage

curl --location 'https://spot-markets.goonus.io/balance?currency_name=USDT' \
--header 'session-token: xxx'

Response Example

[
{
"u": "1",
"c": "ETH",
"t": "99.20000000",
"a": "99.03000000",
"l": "1720747770838"
}
]