Token Discovery

searchTokens

Search tokens by name or symbol. Returns canonical (non-bridged) matches first, deduplicated by symbol. Includes chain deployment addresses for each result.

curl -X POST https://your-endpoint.simplystaking.xyz/v1 \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "searchTokens",
  "params": {
    "q": "usdc",
    "limit": 20
  },
  "id": 1
}'

import { Spectrum } from '@spectrumnodes/sdk';

const spectrum = new Spectrum({ api: 'https://your-endpoint.simplystaking.xyz/YOUR_API_KEY/' });

const result = await spectrum.prices.searchTokens('usdc');
console.log(result);

{
  "jsonrpc": "2.0",
  "result": {
    "data": {
      "count": 1,
      "results": [
        {
          "tokenId": "85022",
          "symbol": "USDC",
          "name": "USDC",
          "priceUsd": 0.999942,
          "chains": [
            {
              "chain": "ethereum",
              "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
              "exponent": 6
            },
            {
              "chain": "solana",
              "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
              "exponent": 6
            }
          ]
        }
      ]
    }
  },
  "id": 1
}

curl -X POST https://your-endpoint.simplystaking.xyz/v1 \
  -H "Content-Type: application/json" \

{
  "jsonrpc": "2.0",
  "method": "searchTokens",
  "params": {
    "q": "usdc",
    "limit": 20
  },
  "id": 1
}

Searchable Tokens

BTCETHSOLUSDCUSDTLINKHYPEwstETHstETHDOTTONNEARMORPHOSSVMOVRKSMsUSDeMRE7YIELDsUSDSAPTSTORYAKTTRXEIGENHBARINITIOTASTRKMONSPKstSPKGLMRBABYFUELSSSSAGAstLINKETHVETHW

Solana Tokens

USDCUSDTLINKSTRKsUSDe

Parameters

Name	Required	Description
q	yes	Search query (name or symbol) e.g. usdc
limit	no	Max results (default 20, max 100) e.g. 20

Response Fields

Field	Type
`data`	object
`count`	integer
`results`	object[]
`tokenId`	string
`symbol`	string
`name`	string
`priceUsd`	number
`chains`	object[]
`chain`	string
`address`	string
`exponent`	integer

Try It

Base URL

q *

limit

JSON-RPC Body

{
  "jsonrpc": "2.0",
  "method": "searchTokens",
  "params": {
    "q": "usdc",
    "limit": 20
  },
  "id": 1
}

getTokenAddresses

Returns all known contract addresses for a token across every chain. Useful for building cross-chain swap/bridge UIs or mapping token contracts across networks.

curl -X POST https://your-endpoint.simplystaking.xyz/v1 \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "method": "getTokenAddresses",
  "params": {
    "symbol": "USDC"
  },
  "id": 1
}'

import { Spectrum } from '@spectrumnodes/sdk';

const spectrum = new Spectrum({ api: 'https://your-endpoint.simplystaking.xyz/YOUR_API_KEY/' });

const result = await spectrum.prices.getTokenAddresses('USDC');
console.log(result);

{
  "jsonrpc": "2.0",
  "result": {
    "data": {
      "symbol": "USDC",
      "name": "USDC",
      "priceUsd": 0.999942,
      "addresses": [
        {
          "chain": "ethereum",
          "chainName": "Ethereum",
          "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
          "decimals": 6
        },
        {
          "chain": "solana",
          "chainName": "Solana",
          "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
          "decimals": 6
        },
        {
          "chain": "base",
          "chainName": "Base",
          "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
          "decimals": 6
        }
      ]
    }
  },
  "id": 1
}

curl -X POST https://your-endpoint.simplystaking.xyz/v1 \
  -H "Content-Type: application/json" \

{
  "jsonrpc": "2.0",
  "method": "getTokenAddresses",
  "params": {
    "symbol": "USDC"
  },
  "id": 1
}

Supported Tokens