> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metastreams.io/llms.txt
> Use this file to discover all available pages before exploring further.

# spot.tokens

> The full token object, every time it changes.

Subscribe on an open stream connection. See [Connecting to streams](/streams/overview) for the connection, frames and reconnecting.

## Filters

<ParamField body="chain" type="string" required>
  The [chain slug](/concepts/chains) the tokens trade on.
</ParamField>

<ParamField body="tokens" type="string[]" required>
  1 to 100 token addresses on `chain`. For one token, you can send `token` with a single address instead.
</ParamField>

To follow tokens on several chains, open one subscription per chain.

## Update

Each update's `data` is the whole token object, sent whenever the token changes. Replace your stored copy with it. [Token details](/reference/rest/token-details) documents every field of that object.

## Errors

| Code | When |
| - | - |
| `VALIDATION_ERROR` | `chain` missing; no address, or more than 100; an address in the wrong format for the chain; an unknown filter field |
| `UNSUPPORTED_CHAIN` | `chain` is not a supported slug |

<RequestExample>
  ```json Subscribe theme={null}
  {
    "action": "subscribe",
    "channel": "spot.tokens",
    "filters": {
      "chain": "solana",
      "tokens": ["DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"]
    }
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Update (shortened) theme={null}
  {
    "type": "update",
    "channel": "spot.tokens",
    "subscriptionId": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
    "data": {
      "chain": "solana",
      "address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "name": "Bonk",
      "symbol": "Bonk",
      "decimals": 5,
      "price": { "native": "0.000000121", "usd": "0.0000216" },
      "marketCap": { "native": "10741962.1", "usd": "1917440000" },
      "liquidity": { "native": "61230.4", "usd": "10929626" },
      "updatedAt": 1789632012345
    }
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.