Marketplace API
Get asset for an address

Get asset for an address#

This API is used to get rune assets under a specific address.

Request address#

GET https://www.okx.com/api/v5/mktplace/nft/runes/get-owned-asserts

Request param#

ParameterTypeRequiredDescription
runesIdStringYesUnique token identifier
walletAddressesStringYesWallet address(es), separated by commas (,) if multiple; up to 20 wallet addresses
cursorStringNoCursor pointing to the sorting sequence to retrieve (maximum 1,000)
limitIntegerNoPagination size (default value 10, maximum 100). Returns the maximum number of entries

Response param#

ParameterTypeDescription
assetIdStringid (DB primary key, no actual meaning)
tickerTypeIntegerToken type (4-Runes)
tickerStringToken name
tickerIdStringToken id
ownerAddressStringWallet address
amountStringXRC20 amount in the UTXO
chainIntegerChain
inscriptionNumStringInscription number
utxoTxHashStringTransaction hash
utxoVoutIntegerutxoVout
utxoValueStringutxoValue
txHashStringTransaction hash
nameStringToken name
tickerIconStringToken icon link
statusIntegerListing status (0-unlisted, 1-listed, 2-pending)
listTimeLongListing time
orderIdLongOrder id
confirmationsLongBlock height information
currencyStringTotal price - currency
currencyUrl String Total price - currency URL
satPriceBigDecimalTotal price in sat
priceBigDecimalTotal price in BTC
usdPriceBigDecimalTotal price in USD
currencyStringUnit price - currency
currencyUrlStringUnit price - currency URL
satPriceBigDecimalUnit price in sat
priceBigDecimalUnit price in BTC
usdPriceBigDecimalUnit price in USD
unavailableInteger1 - UTXO contains multiple Atomicals assets; 2 - UTXO contains multiple protocol assets
symbolStringSymbol

Request example#

shell
curl --location --request GET 'https://beta.okex.org/api/v5/mktplace/nft/runes/get-owned-asserts?runesId=840000:3&walletAddresses=bc1p3fj806enwnmz04444mpm42ykgdcta9p5mvzx46hp8wmg2knpwxpq0k46x9&limit=10' \
--header 'OK-ACCESS-KEY: XXXX' \
--header 'OK-ACCESS-PASSPHRASE: XXXX'

Response example#

200
{
  "code": 0,
  "data": {
  "cursor": "1",
  "items": [
{
  "amount": "500000",
  "assetId": "28912795273673038",
  "chain": 0,
  "confirmations": null,
  "inscriptionNum": "",
  "listTime": 1714399069,
  "name": "DOG•GO•TO•THE•MOON",
  "orderId": 201296,
  "ownerAddress": "bc1p3fj806enwnmz04444mpm42ykgdcta9p5mvzx46hp8wmg2knpwxpq0k46x9",
  "status": 1,
  "symbol": "🐕",
  "ticker": "DOG•GO•TO•THE•MOON",
  "tickerIcon": "https://static.coinall.ltd/cdn/web3/currency/token/1714125941761.png/type=png_350_0",
  "tickerId": "840000:3",
  "tickerType": 4,
  "totalPrice": {
  "currency": "BTC",
  "currencyUrl": "https://static.coinall.ltd/cdn/nft/4834651a-7c4e-4249-91c1-cf680af39dc0.png",
  "price": "0.031895",
  "satPrice": "3189500",
  "usdPrice": "1979.7003235"
},
  "txHash": "",
  "unavailable": null,
  "unitPrice": {
  "currency": "BTC",
  "currencyUrl": "https://static.coinall.ltd/cdn/nft/4834651a-7c4e-4249-91c1-cf680af39dc0.png",
  "price": "0.00000006379",
  "satPrice": "6.379",
  "usdPrice": "0.003959400647"
},
  "utxoTxHash": "ce302f5c946ff3ef502eade58405d64b545d59de9fcd731314b88ddadf709ca6",
  "utxoValue": "546",
  "utxoVout": 2
}
  ]
},
  "msg": ""
}