spot.trades - Chronos API

{
  "action": "subscribe",
  "channel": "spot.trades",
  "filters": { "chain": "solana", "token": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" },
  "id": "bonk-trades"
}

{
  "action": "subscribe",
  "channel": "spot.trades",
  "filters": { "chain": "base", "wallet": "0x4c2f1b6a8e0d7c9b3a5f2e1d0c9b8a7f6e5d4c3b" }
}

{
  "action": "subscribe",
  "channel": "spot.trades",
  "filters": { "identity": "kol", "flags": ["whale"] }
}

{
  "type": "update",
  "channel": "spot.trades",
  "subscriptionId": "5f0c6d1e-8a2b-4c3d-9e4f-1a2b3c4d5e6f",
  "data": {
    "id": "4xQmVb8e2kT1nR7pZcW3sLdHfA9jEuY6gVnX1oB5iC0wQ2rT8yU3iO7pA1sD4fG6h:2",
    "chain": "solana",
    "token": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    "name": "Bonk",
    "symbol": "Bonk",
    "trader": "7YttLkHDoNj9wyDur5pM1ejNaAvT9X4eqaYcHQqtj2G5",
    "transactionHash": "4xQmVb8e2kT1nR7pZcW3sLdHfA9jEuY6gVnX1oB5iC0wQ2rT8yU3iO7pA1sD4fG6h",
    "side": "buy",
    "amount": "12500000",
    "price": { "native": "0.000000121", "usd": "0.0000216" },
    "volume": { "native": "1.51", "usd": "270.12" },
    "marketCap": { "native": "10741962.1", "usd": "1917440000" },
    "timestamp": 1789632015120
  }
}

{
  "action": "subscribe",
  "channel": "spot.trades",
  "filters": { "chain": "solana", "token": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" },
  "id": "bonk-trades"
}

{
  "action": "subscribe",
  "channel": "spot.trades",
  "filters": { "chain": "base", "wallet": "0x4c2f1b6a8e0d7c9b3a5f2e1d0c9b8a7f6e5d4c3b" }
}

{
  "action": "subscribe",
  "channel": "spot.trades",
  "filters": { "identity": "kol", "flags": ["whale"] }
}

{
  "type": "update",
  "channel": "spot.trades",
  "subscriptionId": "5f0c6d1e-8a2b-4c3d-9e4f-1a2b3c4d5e6f",
  "data": {
    "id": "4xQmVb8e2kT1nR7pZcW3sLdHfA9jEuY6gVnX1oB5iC0wQ2rT8yU3iO7pA1sD4fG6h:2",
    "chain": "solana",
    "token": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    "name": "Bonk",
    "symbol": "Bonk",
    "trader": "7YttLkHDoNj9wyDur5pM1ejNaAvT9X4eqaYcHQqtj2G5",
    "transactionHash": "4xQmVb8e2kT1nR7pZcW3sLdHfA9jEuY6gVnX1oB5iC0wQ2rT8yU3iO7pA1sD4fG6h",
    "side": "buy",
    "amount": "12500000",
    "price": { "native": "0.000000121", "usd": "0.0000216" },
    "volume": { "native": "1.51", "usd": "270.12" },
    "marketCap": { "native": "10741962.1", "usd": "1917440000" },
    "timestamp": 1789632015120
  }
}

Subscribe on an open stream connection. See Connecting to streams for the connection, frames and reconnecting.

Filters

Send exactly one mode: token, wallet or identity.

string

The chain slug. Required with token or wallet. Ignored with identity, which covers every chain, though an unsupported slug is still refused.

string

Stream every trade on this token.

string

Stream every trade by this wallet.

string

Stream trades by notable wallets on every chain. kol covers wallets labelled as key opinion leaders. fomoscan covers wallets with a fomo.family profile.

string[]

Keep only trades whose trader carries at least one of these wallet classifications, such as sniper or bundler. fomo matches trades routed through the fomo.family terminal, and trades with no known terminal by wallets flagged fomo. Leave it out to keep every trade.

Update

Each update’s data is one trade, in the same shape the REST trade endpoints return, with fields left out by mode:

Mode	Left out
`token`	`flags`, `platforms`
`wallet`	`platforms`
`identity`	`platforms`

The flags filter still applies in token mode, even though updates leave the field out.

string

required

A stable, opaque ID for the trade. One transaction can hold several trades, so this is not the transaction hash. Never parse it.

string

required

The chain slug the trade executed on.

string

required

The traded token’s address.

string

required

The token’s name. Empty until the token’s metadata resolves.

string

required

The token’s symbol. Empty until the token’s metadata resolves.

string

required

The wallet that sent the swap.

string

required

The on-chain transaction hash.

string

required

buy or sell.

decimal string

required

Token units traded.

money object

required

The token’s price at execution.

money object

required

The trade’s value.

money object

required

The token’s market cap at execution.

string[]

The trader’s wallet classifications, such as sniper or bundler. Left out when empty. New values can appear; keep ones you do not recognize.

object[]

The trading terminals the trade routed through. Left out when empty.

Show platform

string

required

The terminal, such as axiom, bananaGun, bullX, gmgn, maestro, photon, trojan or fomo. New values can appear.

object[]

The trader’s resolved public profiles, one per source. Left out when empty. Every field of a profile is present, and any field except source can be null.

Show identity

string

required

Who resolved the profile, such as codex or fomoscan. New values can appear.

string | null

required

The wallet’s handle on the source.

string | null

required

A name to display.

string | null

required

An avatar image URL. null until the image is available.

string | null

required

The linked X handle.

string | null

required

The linked Telegram handle.

string | null

required

The linked Farcaster handle.

integer

required

When the trade executed, in milliseconds.

Errors

Code	When
`VALIDATION_ERROR`	No mode or more than one mode; `chain` missing with `token` or `wallet`; an address in the wrong format for the chain; an unknown `identity` or `flags` value; an unknown filter field
`UNSUPPORTED_CHAIN`	`chain` is not a supported slug

{
  "action": "subscribe",
  "channel": "spot.trades",
  "filters": { "chain": "solana", "token": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" },
  "id": "bonk-trades"
}

{
  "action": "subscribe",
  "channel": "spot.trades",
  "filters": { "chain": "base", "wallet": "0x4c2f1b6a8e0d7c9b3a5f2e1d0c9b8a7f6e5d4c3b" }
}

{
  "action": "subscribe",
  "channel": "spot.trades",
  "filters": { "identity": "kol", "flags": ["whale"] }
}

{
  "type": "update",
  "channel": "spot.trades",
  "subscriptionId": "5f0c6d1e-8a2b-4c3d-9e4f-1a2b3c4d5e6f",
  "data": {
    "id": "4xQmVb8e2kT1nR7pZcW3sLdHfA9jEuY6gVnX1oB5iC0wQ2rT8yU3iO7pA1sD4fG6h:2",
    "chain": "solana",
    "token": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    "name": "Bonk",
    "symbol": "Bonk",
    "trader": "7YttLkHDoNj9wyDur5pM1ejNaAvT9X4eqaYcHQqtj2G5",
    "transactionHash": "4xQmVb8e2kT1nR7pZcW3sLdHfA9jEuY6gVnX1oB5iC0wQ2rT8yU3iO7pA1sD4fG6h",
    "side": "buy",
    "amount": "12500000",
    "price": { "native": "0.000000121", "usd": "0.0000216" },
    "volume": { "native": "1.51", "usd": "270.12" },
    "marketCap": { "native": "10741962.1", "usd": "1917440000" },
    "timestamp": 1789632015120
  }
}

​Filters

​Update

​Errors

Filters

Update

Errors