Launchpad API
Trades
Query recent trades across all tokens or for a specific token
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Query recent trades across all tokens or for a specific token
GET /api/trades/recent
| Parameter | Type | Default | Description |
|---|---|---|---|
token_address | string | (all tokens) | Filter to a specific token’s CW20 contract address |
limit | number | 50 | Number of trades to return (1-100) |
# Latest 50 trades across all tokens
curl http://67.205.164.156:3001/api/trades/recent
# Latest 20 trades for a specific token
curl "http://67.205.164.156:3001/api/trades/recent?token_address=xyz1cw20contract...&limit=20"
{
"trades": [
{
"time": "2026-02-19T10:05:30.000Z",
"block_height": 152345,
"tx_hash": "A1B2C3D4E5F6...",
"source": "amm",
"action": "swap",
"direction": "xyz_to_token",
"token_address": "xyz1cw20contract...",
"price_uxyz": "52000",
"volume_uxyz": "100000000",
"volume_token": "1923076923",
"fee_uxyz": "1000000",
"trader": "xyz1useraddress...",
"token_name": "Example Token",
"token_symbol": "EXT"
}
]
}
| Field | Type | Description |
|---|---|---|
time | string | Trade timestamp (ISO 8601) |
block_height | number | Block where the trade was included |
tx_hash | string | Transaction hash (use with Chain API to get full tx details) |
source | string | "launchpad" (bonding curve) or "amm" (graduated pool) |
action | string | What happened: "buy", "sell", "swap", "buy_and_graduate" |
direction | string | "xyz_to_token" (buy) or "token_to_xyz" (sell) |
token_address | string | CW20 contract address of the token traded |
price_uxyz | string | Price at time of trade (uxyz per token, scaled by 10^6) |
volume_uxyz | string | XYZ volume of this trade in uxyz |
volume_token | string | Token volume of this trade in micro-units |
fee_uxyz | string | Fee paid in uxyz |
trader | string | Address that executed the trade |
token_name | string | null | Token name (joined from token metadata) |
token_symbol | string | null | Token symbol |
| Action | Source | Meaning |
|---|---|---|
buy | launchpad | Bought tokens on the bonding curve |
sell | launchpad | Sold tokens back to the bonding curve |
buy_and_graduate | launchpad | Buy that triggered graduation (curve closed, AMM pool created) |
swap | amm | Swapped on the AMM (either direction) |