Skip to navigation
REST APIReference dataAssets

Get an asset

One asset by id. A removed asset is 404.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

assetIdstringRequired
The asset id.

Headers

X-Request-IdstringOptional

Your own id for the request: 8 to 128 of [A-Za-z0-9._-]. It becomes the request’s id and is echoed on the response. A value off that grammar is replaced with a fresh id, never refused.

Response

The asset.
assetIdstring
The asset's id. Ids are opaque strings.
symbolstring

The asset’s symbol, as instrument symbols spell it: the BTC in OKX@BTC/USDT.

typestring

The asset class: COIN, TOKEN, FIAT, STABLE_COIN, INDEX, COMMODITY, STOCK or OTHER. Append-only: tolerate values you don’t know.

updatedAtNsstring or nullformat: "^[0-9]+$"
When the asset record last changed, as a sequencer timestamp in epoch nanoseconds. Null when unknown.

Errors

400
Get Assets Request Bad Request Error
401
Get Assets Request Unauthorized Error
404
Get Assets Request Not Found Error
503
Get Assets Request Service Unavailable Error