Raze.bot Developers

One API for five chains: Solana, Ethereum, BNB Chain, Base and Robinhood Chain. REST answers snapshots; one WebSocket (or one Server-Sent Events stream per channel) pushes everything that moves. Routes sit at the root of https://api.raze.bot (for example GET /tokens/sol/{mint}); the contract is also served as OpenAPI at GET /openapi.yaml.

Quickstart

First request in curl, Node and Python

Conventions

data / next / error, units, null

Authentication

x-api-key, Bearer, or ?apiKey=

Streaming

One WebSocket, six channels

Tokens

{chain} is sol, eth, bsc, base or robinhood; {address} is the mint or contract.

Path	`data`	Query
`GET /tokens/{chain}/{address}`	`Token`	—
`GET /tokens?ids=`	`Token[]`	up to 50 `chain:address`
`GET /tokens/{chain}/{address}/trades`	`Trade[]` + `next`	`limit` ≤ 200, `cursor`, `wallet`
`GET /tokens/{chain}/{address}/candles`	`Candle[]`	`interval` (1s…1w), `from`, `to` (ms), `limit` ≤ 1000, `unit`
`GET /tokens/{chain}/{address}/holders`	`Holder[]`	`limit` ≤ 100
`GET /tokens/{chain}/{address}/traders`	`Holder[]`	`limit` ≤ 100
`GET /tokens/{chain}/{address}/image`	`302` to the image	—

Discovery

Path	`data`	Query
`GET /search`	`TokenSummary[]`	`q`, `chain`, `limit` ≤ 50
`GET /trending`	`RankedToken[]`	`chain` (default `sol`), `interval`, `sort`, `limit` ≤ 100
`GET /screener`	`RankedToken[]`	`chain`, `sort`, `interval`, ranges, `creator`, `graduated`, `includeScams`, `limit` ≤ 100, `offset` ≤ 5000
`GET /launchpad/{new\|graduating\|graduated}`	`TokenSummary[]`	`chain`, `limit` ≤ 200 (`new` and `graduated` hold 100 per chain)

Wallets and prices

Path	`data`	Query
`GET /wallets/top`	`WalletStats[]`	`chain` (default `sol`), `period`, `sort`, `limit` ≤ 100
`GET /wallets/{chain}/{address}`	`WalletStats`	`period` (`1d`, `7d`, `30d`, `1y`)
`GET /wallets/{chain}/{address}/holdings`	`Holding[]` + `next`	`limit` ≤ 100, `cursor`
`GET /wallets/{chain}/{address}/pnl`	`PnlPoint[]`	`days` (1–365, default 30), `resolution` (`1d`, `1h`)
`GET /wallets/{chain}/{address}/trades`	`WalletTrade[]` + `next`	`limit` ≤ 100, `cursor`
`GET /prices`	`{sol, eth, bnb}`, or `TokenPrice[]` with `tokens=`	`tokens` (up to 100 `chain:address`)

Catalog

Path	`data`
`GET /chains`	`Chain[]`
`GET /`	the route list (a plain object, no `data`)	No key
`GET /health`	service and live-view health (no `data`)	No key; `503` when a live feed is down
`GET /openapi.yaml`	the contract, as YAML	No key

Live

GET /ws (WebSocket, also at wss://ws.raze.bot) or GET /stream/{channel} (SSE). Every channel sends a snapshot first, then changes.

Channel	Parameters	After the snapshot
`trades`	`chain`, `token`	`trade` on every trade; on Solana, `retract` when a block loses its fork
`candles`	`chain`, `token`, `interval`, `unit`	`candle`: the forming candle, on every trade
`token`	`chain`, `token`	`tick` (price, market cap) on every trade; the full token again at most every 15 s while it trades
`launchpad`	`board`, `chain` (optional)	`add`, `update`, `remove`
`prices`	—	`update` (SOL, ETH, BNB)
`wallet`	`wallet` (Solana)	`trade` on every swap of the wallet

Status codes

HTTP	`error.code`	When
200	—	Success, including an empty list
400	`bad_request`	A parameter is missing or wrong (unknown chain, bad address, …)
401	`unauthorized`	Missing or unknown key
404	`not_found`	Unknown route, or an unknown token
429	`rate_limited`	Over the rate a second of the key (or of its account), burst included
503	`upstream_unavailable`	The data could not be loaded right now; send the same request again after `Retry-After`
503	`server_busy`	A new WebSocket or SSE connection while the server is at capacity; connect again after `Retry-After`

Changelog

Overview

Quickstart

Conventions

Authentication

Streaming

Tokens

Discovery

Wallets and prices

Catalog

Live

Status codes

Quickstart

Conventions

Authentication

Streaming

​Tokens

​Discovery

​Wallets and prices

​Catalog

​Live

​Status codes

Tokens

Discovery

Wallets and prices

Catalog

Live

Status codes