Skip to main content
GET
Transactions
The individual buy and sell transactions of tracked wallets on one token, newest first. Each entry carries the trader profile, the trade value and token amount, and the holder position after that trade, so you can replay how positions built up or unwound. Use it to render a live trade tape for a token, the scrolling feed of who bought or sold and when. The token block carries the market cap, and every trade carries the market cap at the moment it happened, so you can place it on a chart.
These are individual events, not positions, so they do not carry unrealized PnL. Each transaction includes holdings_after, the holder bag right after that trade. The list is newest first and paginated with limit and cursor. Poll with since to receive only new trades: a poll that finds nothing new costs 0 credits.

Query Parameters

string
required
Chain of the token. One of solana, bnb, base, eth, rh (Robinhood Chain).
string
required
The token mint or contract address.
string
Optional wallet category kol, smart or whale. Omit to include all categories.
integer
Maximum number of transactions per page. Without limit and cursor the full list is returned.
string
Opaque cursor for the next page. Pass the next_cursor value from the previous response, together with the same limit. A null next_cursor means there are no more pages.
string
Only return transactions at or after this time. Accepts Unix seconds, Unix milliseconds or an ISO 8601 timestamp in UTC. The bound is inclusive so no trade in the same second is lost, so deduplicate by tx_signature. If no transaction is newer than since, the request costs 0 credits.
string
Your API key, required on https://api.cabalspy.xyz. Alternatively pass it as an Authorization Bearer header. Not needed on the demo server https://demo-api.cabalspy.xyz.
Try it without an API key: Try it runs on the demo server https://demo-api.cabalspy.xyz (20 requests per IP per day, data delayed 15 minutes, at most 5 rows), so you can send a request without a key. For live data, switch the server to https://api.cabalspy.xyz and enter your API key. Your own integration always calls api.cabalspy.xyz with your API key, as in the usage examples below. Get a free key · About the demo

Polling for new trades

To keep a chart or trade tape current, pass the created_at of the newest trade you already have as since. You get only the new trades, and a poll that finds nothing new is free. The X-Credits-Charged response header shows what a request cost.
For a live feed, the Transactions Stream filtered to one token is cheaper still: it pushes each trade the moment it happens and bills 1 credit per delivered trade, instead of polling.

Usage Example

Response

boolean
True on success.
object

Errors