CRIUS Docs
API status Get API key
Trades & candles

Trade tape

Newest first. Each trade carries side, amounts in human units, USD and ETH value, the price, pool and DEX, the attributed trader, gas and token tax, and its…

GET https://api.crius.sh/v1/{chain}/token/{address}/trades
Anonymous and above (no key needed) 2 credits per call Runnable here Updated Oct 28, 2026

Newest first. Each trade carries side, amounts in human units, USD and ETH value, the price, pool and DEX, the attributed trader, gas and token tax, and its finality (latest → safe → finalized). Filter by side, trader, min_usd and a time range; paginate with cursor. USD values are computed when the trade is indexed: the quote amount times the quote's USD price at that block, from on-chain markets (ETH via the WETH/USDG pool). eth_usd_at_trade is that block's ETH/USD (exact for ETH and WETH-quoted trades: value_usd / value_eth); price_eth comes from the amounts for ETH-quoted trades, else from price_usd and that rate. In the chain's first days (before about June 24, 2026) the WETH/USDG pool was new and thin, so USD values from then are estimates from its spot price.

Real trader attribution, USD at trade time, realized tax, gas (L2 + L1).

Path parameters

chainstringrequired

Chain slug (robinhood) or chain id (4663).

addressstringrequired

Contract or wallet address, any case (0x…, 20 bytes).

Query parameters

limitinteger Default 50

Maximum number of items to return. Up to 500.

cursorstring

Pagination cursor from the previous response's meta.next_cursor.

sidestring

buy or sell.

traderstring

Only trades by this trader address.

min_usdnumber

Only items worth at least this many USD.

from_tsinteger

Start of the time range, unix milliseconds (inclusive).

to_tsinteger

End of the time range, unix milliseconds (inclusive).

appstring

Fomo: only trades made through this app, executed by its relayers (the relayer shows as signer_label; trader_app marks the app's own smart wallets)

Guides that use this endpoint

Get OHLCV candles for Robinhood Chain tokens (OHLCV API)Robinhood Chain OHLCV API: candles for any token from 1 second to 1 day, with buy volume, trade count and market cap per candle. Real examples and chart code.Stream Robinhood Chain trades over WebSocketStream every trade of a Robinhood Chain token, pool or wallet over the Crius WebSocket, with Node.js and Python clients that reconnect, resume and backfill.Get every trade of a Robinhood Chain token (trade tape)Get every buy and sell of a Robinhood Chain token with USD value, price, gas, tax and the real trader behind routers and smart wallets. Real examples, no key.Stream live candles for a Robinhood Chain token chartKeep a Robinhood Chain candlestick chart live: load candles over REST, update the last bar from the Crius WebSocket, with a runnable Node.js relay.Get a token's full activity feed (trades, transfers, liquidity)Get every event of a Robinhood Chain token in one feed, from trades and transfers to liquidity, burns, owner actions, locks and graduation, with real examples.Find a token's top traders and their PnLRank the traders of any Robinhood Chain token by PnL, volume, buys or ROI, with wallet tags, gas and hold time. A real example with the PnL math explained.Move from raw RPC calls to the Crius API on Robinhood ChainReplace eth_getLogs scans, slot0 math and Transfer replays with Crius API calls on Robinhood Chain: a mapping table, before/after code and credit costs.Get a wallet's trade historyList every trade a Robinhood Chain wallet made across all tokens, with USD value at trade time, market cap, DEX and gas. Filter by token, side, size, time.Robinhood Chain DEX data: which DEXs trade, and how to get their trades, pools and volumeWhich DEXs trade on Robinhood Chain (Uniswap v2, v3, v4 with hooks, launchpad curves), their real 24h volume and pools, and the API calls for DEX trades.Robinhood Chain API for trading botsWhat a Robinhood Chain trading bot needs from the Crius API: new launches, live prices, pools and safety checks before every buy, with credit costs.

Errors

Errors come back as { "error": { "code", "message" } } with the matching HTTP status: 400 bad parameter, 401 missing or invalid key, 403 endpoint above your plan, 404 unknown token or address, 429 rate limit or credits used up (with Retry-After). See Errors.

More trades & candles endpoints

GET/token/{address}/candlesOHLCV candlesAnonymous · 2 crGET/token/{address}/transactionsActivity feedFree · 2 cr

Get your free Crius API key

Every example on this page works with a free key: higher rate limits than the anonymous plan, holders, wallets and the WebSocket stream. No card needed.

Get a free API key See plans
  • Robinhood Chain (4663) only, from our own archive nodes
  • REST + WebSocket
  • Pay on-chain or by card