Token trades
The last ~200 trades for a mint, newest first, filtered to trades of 0.2 SOL or more. Each trade includes the trader's stats as they were at the moment of the trade, so one row is enough to replay a signal.
GET
/v1/tokens/:mint/trades
recent trades for one mint
Example
curl -sS -H "Authorization: Bearer $API_KEY" \
https://api.cookin.fun/v1/tokens/BgNrWZKAaZAa.../tradesResponse — each trade
{
"data": [
{
"signature": "5xyz...",
"slot": 12345,
"timestamp": "2026-07-11T13:00:00Z",
"mint": "BgNrWZK...",
"user_address": "wallet...",
"user_name": "🦍 Alvin",
"is_buy": true,
"sol_amount": 0.5,
"token_amount": 1234567.0,
"mcap": 12346,
"user_sol_balance": 12.5,
"user_pnl": -3.2,
"roi": 1.42,
"win_rate": 65.0,
"total_buys_sol": 150.0,
"buys_count": 23,
"bundled_trades_rate": 5.5,
"healthy_coins_rate": 38.0,
"sell_impact": -2.59,
"avg_hold_slots": 240.0,
"smart_money": false,
"bundled": false,
"bundle_id": null,
"bundle_name": null
}
],
"meta": { ... }
}
Per-trade fields
Every trade carries the tx envelope plus the trader's stats snapshotted at trade time — win_rate, roi, etc. reflect the trader's history as of that moment. That means you can replay a trade row as a standalone signal without joining external data.
| Field | Type | Description |
|---|---|---|
signature | string | Solana tx signature. |
slot | integer | Slot number. |
timestamp | string (ISO 8601) | Block time. |
mint | string | Same mint you queried. |
user_address | string | Wallet that traded. |
user_name | string | null | Display name (KOL handle, etc.) if known. |
is_buy | bool | True on buys, false on sells. |
sol_amount, token_amount | float | Signed magnitudes — absolute value, sign encoded in is_buy. |
mcap | integer | Mcap in USD at trade time. |
user_sol_balance | float | null | Wallet's SOL balance at trade time. |
user_pnl | float | null | Trader's total PnL (SOL, signed). |
roi | float | null | Trader's historical ROI as a ratio (0.5 = +50%). |
win_rate | float | null | % of trades in profit (0..100). |
total_buys_sol | float | null | Trader's lifetime SOL volume bought. |
buys_count | integer | null | Trader's lifetime buy count. |
bundled_trades_rate | float | null | % of trader's past trades that ran in a bundle. |
healthy_coins_rate | float | null | Alpha Hands metric — % of trader's past coins that performed well. |
sell_impact | float | null | Trader's avg % chart drop on sell. |
avg_hold_slots | float | null | Trader's avg hold duration in Solana slots. |
smart_money | bool | Trader's smart-money flag. |
bundled | bool | True if this trade ran in a confirmed bundle. |
bundle_id, bundle_name | integer/string | null | Bundle identity when bundled is true. |