Get Token Details by Pubkey or Search Tokens
GET
https://api.sparkscan.io
/v1/tokens/{identifier}
If the path segment is a 64-character hex token identifier or a Bech32 token address, returns its details. Otherwise the segment is treated as a search query over token name, ticker or address.
path Parameters
identifierstring · required
query Parameters
networkstring · enum · requiredEnum values:REGTESTMAINNETlimitinteger · min: 1 · max: 100Limit for search results if identifier is a query string
Limit for search results if identifier is a query string
Default: 25offsetinteger · min: 0Offset for search results if identifier is a query string
Offset for search results if identifier is a query string
Default: 0
Responses
Successful Response
anyOf
At least one variant must match. Multiple variants may match simultaneously.
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: metadata, totalSupply, marketCapUsd +1 more | |
| type = array |
metadataobject · requiredtotalSupplyinteger · requiredmarketCapUsdnumber · float · requiredvolume24hUsdnumber · float · required
Get Token Metadata in Batch
POST
https://api.sparkscan.io
/v1/tokens/metadata/batch
Retrieve metadata for up to 100 tokens at once. Uses Redis cache and RPC nodes as fallback, following the same logic as individual token endpoints.
query Parameters
networkstring · enum · requiredEnum values:REGTESTMAINNET
Request Body
token_addressesstring[] · minItems: 1 · maxItems: 100 · requiredList of 66-character hex token addresses
Responses
Successful Response
metadataobject[] · requiredList of token metadata objects
total_countinteger · requiredTotal number of tokens processed
Lookup token ↔ issuer pubkey
POST
https://api.sparkscan.io
/v1/tokens/issuer-lookup