Spark Address Summary

This endpoint returns summary data for a Spark address — balances, holdings, and recent activity.

get

Get address summary

Authorizations

apiKey

x-api-keystringRequired

Path parameters

addressstringRequiredExample: spark1pgssxxkz8lp9zpcjwz5pfm062ncle9mumvkuaq9d39t2cgm4lacq2agtdmv2tl

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}

HTTPcURLJavaScriptPython

GET /v1/spark/address/{address} 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"
    }
  ]
}