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.
Input Schema
TableJSON 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
TableJSON 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. |