Assets
GET /v2/assets
List supported assets
Parámetros
| Parámetro | En | Tipo | Requerido | Descripción |
|---|---|---|---|---|
page | query | integer | no | Default: 1. |
limit | query | integer | no | Default: 25. |
Respuestas
| Código | Descripción | Cuerpo |
|---|---|---|
200 | Éxito. | data: AssetResource[] · pagination: PaginationMeta |
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/assets/{assetSymbol}
Get a supported asset by its symbol
Reference data is identical for every key, so this response does not depend on who asks.
Parámetros
| Parámetro | En | Tipo | Requerido | Descripción |
|---|---|---|---|---|
assetSymbol | path | string | sí | The asset code published as assetSymbol by GET /v2/assets (e.g. BTC, NVDASPV). Case-insensitive. |
Respuestas
| Código | Descripción | Cuerpo |
|---|---|---|
200 | Éxito. | AssetResource |
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
AssetResource
| Campo | Tipo | Descripción |
|---|---|---|
assetSymbol | string | Asset code. This is the value every endpoint takes as assetSymbol — there is no bare asset parameter anywhere on the public API. Ej.: BTC. |
assetName | string | Ej.: Bitcoin. |
assetClass | FIAT | STABLECOIN | STOCK | CRYPTO | What kind of asset this is. STOCK is a tokenised equity (xStock) and is the only class whose amounts rebase — see rebaseMultiplier. Do not infer this from any numeric field. Ej.: CRYPTO. |
amountIncrement | string | Smallest amount step Skipo operates on for this asset. An amount finer than this is TRUNCATED — not rejected, and not rounded up. Ej.: 0.00000001. |
displayIncrement | string | Step Skipo uses when DISPLAYING this asset — coarser than amountIncrement. Presentation only; never validate an amount against it. Ej.: 0.01. |
minimumDeposit | string | Smallest deposit that will be credited. Ej.: 0.0001. |
minimumWithdrawal | string | Smallest withdrawal to an external destination. Ej.: 0.001. |
minimumInternalWithdrawal | string | Smallest withdrawal to another Skipo account. Usually lower than the external minimum, because no network fee is involved. Ej.: 0.0001. |
withdrawalFee | string | Flat fee the account pays Skipo for an external withdrawal of this asset, charged in that same asset. "0" for fiat. Deposits are always free. Ej.: 0.0005. |
maxIndicativeQuoteAmount | string | Largest amount Skipo will quote for an account with no balance and no available credit. A quote within this limit is INDICATIVE — priced, but confirming it still requires funds. Ej.: 0.2. |
rebaseMultiplier | string | Rebase factor currently in effect for a tokenised equity: one share = rebaseMultiplier settled tokens. "1" for every non-rebasing asset. This is the CURRENT factor — to render a PAST trade, use the point-in-time multiplier on the fill, never this one. Ej.: 1. |
networks | NetworkResource[] | Networks this asset can be withdrawn over. Empty for fiat. |
NetworkResource
| Campo | Tipo | Descripción |
|---|---|---|
networkSymbol | string | Upstream network identifier, passed through UNNORMALIZED — do not treat it as a stable key or parse it. Formats are inconsistent and mix three unrelated kinds of value: chain symbols (BTC, SOL, ETH), token standards that are not chains at all (ERC20, BEP20), and prose (Dogecoin, Stellar Network, XRP Ledger). BEP20 and BSC are the same chain under two names. A canonical network registry is owned by maintainers (SPEC Phase 2g); until it lands this field is descriptive only, and a later release will replace it with normalized values. Use assetSymbol as the key for anything durable. Ej.: BTC. |
networkName | string | Human-readable network name. Ej.: Bitcoin. |
withdrawalFee | string | Fee charged for a withdrawal over this network, denominated in the asset itself. Ej.: 0.0005. |
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.