get_recent_trades
Read filtered market swap summaries from PumpView's supported SOL-pair feed.
Use for recent market activity, not your submitted swap receipt (get_swap_status).
Requires a Bearer key, active data grant and sufficient key budget. Each call
consumes max(1, returned event count) credits; repeated reads also count.
Unlimited has no package event cap, but an explicit key budget still applies.
Returns events in feed order, a cursor and health. Filtering follows batch
scanning, so advance using the returned cursor even for an empty batch.
On 409 cursor_expired restart without after and record a gap; 402 means access
or budget exhausted, 503 means unavailable source. Use get_stream_connection
for continuous WSS delivery. Amounts are decoder floats, not full transaction accounting.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_recent_trades"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mint | No | Optional exact token mint address in base58. Filters the traded token of the supported SOL-pair feed; omit for all mints. No ticker aliases. | |
| after | No | Opaque cursor returned by the previous batch. Omit for a recent snapshot; supply unchanged to scan subsequent events. Not a timestamp or transaction signature. | |
| limit | No | Maximum accepted events scanned before mint/wallet filters, 1-500; default 100. The number returned can be smaller, including zero. | |
| wallet | No | Optional exact base58 trader public key reported by the decoder. Combined with mint using AND; omit for all wallets. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | Yes | Resume position after the scanned batch, including events removed by filters; use as the next after value. | |
| events | Yes | Accepted events after mint/wallet filtering. May be empty even when the cursor advances. | |
| health | No | Feed connection status, last-message age, drop/replay-gap counters and price_filter identifier. |