Spark Balances

This endpoint returns BTKN token balances for a given Spark address, including token identifiers, symbols, and amounts.

get

Get token balances for a specific Spark address.

Authorizations

apiKey

x-api-keystringRequired

Path parameters

addressstringRequired

Spark address e.g. sp...

Responses

200

Default Response

application/json

sparkAddressstringOptional

publicKeystringOptional

totalValueUsdnumberOptional

transactionCountnumberOptional

tokenCountnumberOptional

400

Invalid input

application/json

401

Unauthorized

application/json

404

Not found

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/v1/spark/address/{address}/btkn

HTTPcURLJavaScriptPython

GET /v1/spark/address/{address}/btkn HTTP/1.1
Host: api.secretkeylabs.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "sparkAddress": "text",
  "publicKey": "text",
  "balance": {
    "btcSoftBalanceSats": 1,
    "btcHardBalanceSats": 1,
    "btcValueUsdHard": 1,
    "btcValueUsdSoft": 1,
    "totalTokenValueUsd": 1
  },
  "totalValueUsd": 1,
  "transactionCount": 1,
  "tokenCount": 1,
  "tokens": [
    {
      "tokenIdentifier": "text",
      "tokenAddress": "text",
      "name": "text",
      "ticker": "text",
      "decimals": 1,
      "issuerPublicKey": "text",
      "maxSupply": 1,
      "isFreezable": true,
      "iconUrl": "text"
    }
  ]
}