Trades

Every trade as it lands: side, price, amount, value and wallet.

What you get

Every trade on the token, sent as it lands, one event per trade. Measured on a busy token, trades reach you within a second or so of the chain.

  • Channel: token.trades
  • Subscribe with one or more token addresses, up to twenty per connection.
  • Event channel: nothing is kept and nothing is replayed, so you receive what happens while you are subscribed.
  • New here? Start with the stream overview: connecting, the event envelope, heartbeats and limits.

Subscribe

json
{ "id": 1, "method": "subscribe", "stream": "token.trades", "keys": ["<token address>"] }

An event

json
{
  "id": "9f3ac41b02d84e7fa61c5b9e4d02f118",
  "stream": "token.trades",
  "type": "update",
  "chain": "robinhood",
  "key": "0x39dbed3a2bd333467115de45665cc57f813c4571",
  "seq": 12,
  "unix": 1758182401,
  "data": {
    "token": "0x39dbed3a2bd333467115de45665cc57f813c4571",
    "chain": "robinhood",
    "side": "sell",
    "priceUsd": 0.66787533,
    "amount": 0.020241,
    "totalUsd": 0.013518,
    "wallet": "0xa52abeb9a19cec601e4dc8dff32bde5a6457d833",
    "txHash": "0x3570877e333c49c16f35e7b7dad9f631aa78c09a8b75e5e6357626c91b32df23",
    "tradeUnix": 1789754574
  }
}

Try it live

Connect from this page and watch this channel run. Your browser talks to the stream directly, so what arrives here is what your own client would get.

Not connectedwss://api.xaxios.com/v1/stream

Pick a channel and connect. Nothing is sent anywhere but your browser.

Fields

Everything inside data. A field is null when we have nothing to report for it, which never means zero.

FieldTypeDescription
tokenstringThe token the trade belongs to, as we key it.
chainstring"solana" or "robinhood".
sidestring"buy" or "sell", from the trader’s point of view.
priceUsdnumber | nullPrice of one token in this trade, in USD.
amountnumber | nullHow many tokens changed hands, to six decimals.
totalUsdnumber | nullWhat the trade was worth in USD.
walletstring | nullThe wallet that traded.
txHashstring | nullThe transaction on the chain. Build your own explorer link from it.
tradeUnixnumber | nullWhen the trade happened, as a UTC unix timestamp in seconds. Not when we sent it: that is the envelope's unix.

Pair it with the market channel

A trade carries the trade. Market cap, liquidity and holders move on their own clock, so subscribe to token.market for the same token and render both.

One transaction can carry several trades, so txHashrepeating across events is normal. The envelope's id is what is unique per event.

Premium gratuit pendant 2 semaines

Durée limitée, ouvert à tous : toutes les fonctions premium, dont Rug Check, gratuites.

Rug CheckActualitésCalendrier