Balances

GET /v2/balances

List the account asset balances

Respuestas

Código	Descripción	Cuerpo
200	Éxito.	object
401	application/problem+json (RFC 9457) — branch on code, not on the status: unauthorized (not retryable), key_expired (not retryable), key_revoked (not retryable).	—
403	application/problem+json (RFC 9457) — branch on code, not on the status: insufficient_scope (not retryable), ip_not_allowed (not retryable), api_access_disabled (not retryable).	—
429	application/problem+json (RFC 9457) — branch on code, not on the status: rate_limited (retryable).	—
500	application/problem+json (RFC 9457) — branch on code, not on the status: internal_error (retryable).	—
502	application/problem+json (RFC 9457) — branch on code, not on the status: downstream_unavailable (retryable).	—
503	application/problem+json (RFC 9457) — branch on code, not on the status: maintenance (retryable).	—

---

GET /v2/balances/{assetSymbol}/history

Historical balances for an asset

Parámetros

Parámetro	En	Tipo	Requerido	Descripción
assetSymbol	path	string	sí	The asset code published as assetSymbol by GET /v2/assets.
page	query	integer	no	Default: 1.
limit	query	integer	no	Default: 25.
startDate	query	string	no	ISO-8601 start date. Defaults to the first movement.
endDate	query	string	no	ISO-8601 end date. Defaults to now.
granularity	query	day | week | month	no	Default: day.

Respuestas

Código	Descripción	Cuerpo
200	Éxito.	HistoricalBalancesResponse
401	application/problem+json (RFC 9457) — branch on code, not on the status: unauthorized (not retryable), key_expired (not retryable), key_revoked (not retryable).	—
403	application/problem+json (RFC 9457) — branch on code, not on the status: insufficient_scope (not retryable), ip_not_allowed (not retryable), api_access_disabled (not retryable).	—
404	application/problem+json (RFC 9457) — branch on code, not on the status: not_found (not retryable).	—
429	application/problem+json (RFC 9457) — branch on code, not on the status: rate_limited (retryable).	—
500	application/problem+json (RFC 9457) — branch on code, not on the status: internal_error (retryable).	—
502	application/problem+json (RFC 9457) — branch on code, not on the status: downstream_unavailable (retryable).	—
503	application/problem+json (RFC 9457) — branch on code, not on the status: maintenance (retryable).	—

---

Esquemas

BalanceResource

Campo	Tipo	Descripción
assetSymbol	string	Ej.: BTC.
balance	string	Ej.: 500.
balanceFrozen	string	Ej.: 0.
balancePending	string	Ej.: 100.
balancePrefCurrency	string	This balance converted to the account's preferred currency. The unit is not repeated here — read preferredCurrency from GET /v2/account. Named for its unit, like balanceUSD. Ej.: 500.
balanceUSD	string	Ej.: 0.62.
balanceCapacityTotal (opcional)	string
balanceCapacityAvailable (opcional)	string
balanceCapacitySpent (opcional)	string

HistoricalBalancePoint

Campo	Tipo	Descripción
date	string
balance	string	Balance at the end of the period, as an exact decimal string in plain notation — never exponential. Truncated to the asset operating precision. Parse it as a decimal, not a float. Ej.: 500.62.

HistoricalBalancesResponse

Campo	Tipo	Descripción
assetSymbol	string	Ej.: BTC.
granularity	day | week | month
startDate	string | null
endDate	string | null
data	HistoricalBalancePoint[]
pagination	PaginationMeta

PaginationMeta

Campo	Tipo	Descripción
page	number	Ej.: 1.
limit	number	Ej.: 25.
totalItems	number	Ej.: 100.
totalPages	number	Ej.: 4.

Problem

Campo	Tipo	Descripción
type	string	Stable problem-type URI. Resolves to docs for this error. Ej.: https://docs.skipo.com/errors/rate_limited.
title	string	Short, human-readable summary (stable, English). Ej.: Rate limit exceeded.
status	number	HTTP status code. Ej.: 429.
code	string	Stable machine-readable error code (equals the last path segment of type). Ej.: rate_limited.
retryable	boolean	Whether retrying the identical request may succeed. Ej.: true.
detail (opcional)	string	Human-readable, possibly localized detail.
instance (opcional)	string	The request path that produced the error.
traceId (opcional)	string	Trace id — joins BigQuery api_request and Cloud Logging.

---

Volver a la referencia de endpoints. Ver también: Paginación · Errores · Ids y correlación.