CRIUS

DEX data API

Robinhood Chain DEX trades and swap history API

Crius gives you every DEX trade on Robinhood Chain, across Uniswap v2, v3 and v4 and launchpad bonding curves, with the wallet that actually traded rather than the router or bundler that sent the transaction. Query a token's full swap history, a wallet's trades or chain-wide volume over REST, or stream trades as blocks land.

Get a free API key API reference
  • History from block 0
  • REST + WebSocket
  • Free plan: 1M credits / month
  • Robinhood Chain · chain ID 4663

Try it

A real request and its response

Captured from the live API, trimmed for length. Replace $CRIUS_API_KEY with your key; calls without that header work keyless at 2 requests a second.

The latest WETH trade Real response, trimmed
Request 
curl "https://api.crius.sh/v1/robinhood/token/0x0bd7d308f8e1639fab988df18a8011f41eacad73/trades?limit=1"
Response 
{
  "data": [
    {
      "id": "96714110-5-34",
      "type": "sell",
      "block": 96714110,
      "ts": 1792839646000,
      "dex": "uniswap_v3",
      "pool": "0x52e65b17fb6e5ba00ed806f37afcd2daa50271ca",
      "trader": "0x2cb4be652f217cb3169944eb5f0e7a76631cc2f9",
      "signer": "0x2cb4be652f217cb3169944eb5f0e7a76631cc2f9",
      "amount_base": 0.058088,
      "amount_quote": 137.527161,
      "quote_symbol": "USDG",
      "price_usd": 2367.57,
      "value_usd": 137.527,
      "finality": "latest",
      "via": []
    }
  ],
  "meta": {
    "block": 96714192,
    "block_ts": 1792839655000,
    "finalized_block": 96703786,
    "lag_ms": 91,
    "safe_block": 96707359
  }
}

trader is the address whose balance changed; signer sent the transaction; via lists the infrastructure in between (routers, Relay solvers, ERC-4337 bundlers). finality moves from latest to safe to finalized.

What you get

Built for Robinhood Chain, not bolted on

  • Who actually traded

    Trades are attributed to the wallet whose balance changed, so aggregators, solvers and bundlers don't hide the real trader.

  • All venues

    Uniswap v2 pairs, v3 pools at every fee tier, v4 pools with their hooks, and the Pons curve and other launch curves.

  • Full context per trade

    Amounts in human units, price and value in USD and ETH, gas (L2 and L1), token tax paid and market cap at the trade.

  • Filters that matter

    Side, trader, minimum USD size and time range; cursor pagination through the complete history.

  • Finality on every row

    latest → safe → finalized, so you can act fast or wait for settlement.

  • Streaming

    trades:, trades:pool: and wallet:

    push trades the moment a block is decoded.

Endpoints

The calls behind it

Base URL https://api.crius.sh, chain segment robinhood (or 4663). Every response is {data, meta} with the block it reflects.

EndpointReturnsPlanCredits
GET /v1/{chain}/token/{address}/trades A token's trade tape: filter by side, trader, size and time Any (no key) 2
GET /v1/{chain}/wallet/{address}/trades Every trade a wallet made, across all tokens Starter+ 5
GET /v1/{chain}/token/{address}/transactions Unified activity: trades, liquidity, transfers, owner actions Free+ 2
GET /v1/{chain}/pool/{pool} One pool's reserves, fee, hook, TVL and activity Any (no key) 1
GET /v1/{chain}/stats Chain-wide DEX volume, trades and traders per DEX Any (no key) 1

Use cases

  • Trade tapes and terminals
  • Copy-trading and alert bots
  • Swap history exports
  • Volume and wash-trade analysis
  • Tax and accounting tools

Plans and limits

Token trades cost 2 credits and work on every plan; the activity feed needs the Free plan or higher; wallet trades need Starter or higher.

See pricing Plans, limits & credits

Questions about the DEX trades API

Which DEXs are covered?

Uniswap v2, v3 (all fee tiers) and v4 (every pool and hook) on Robinhood Chain, plus launchpad bonding curves such as Pons. Each trade says which DEX and pool it came from.

Can I get the full swap history of a token?

Yes. Page through /trades with the cursor in meta.next_cursor, or narrow it with from_ts and to_ts. History goes back to the token's first trade.

How are reorgs handled?

Rows carry finality. On the stream, a reorg message is followed by the removed events marked removed: true, so your state can be rolled back.

Why is the trader different from the transaction sender?

Many swaps are sent by routers, aggregators, Relay solvers or ERC-4337 bundlers. Crius attributes the trade to the wallet whose balance actually changed and reports the sender separately as signer, with the infrastructure in via.

Is there a trading API to place swaps?

No. Crius is a read API for market data. To trade, send transactions through your own wallet or an RPC provider; Crius tells you what happened and at what price.

Related APIs

Guides and articles

Documentation

Trades & candles reference →Pools & hooks reference → All Robinhood Chain APIs → Compare providers →

Start with the free plan

1,000,000 credits a month, no card. Your key in under a minute.

Get a free API key Try the playground