Find Solana transactions
portal_solana_query_transactionsRetrieve raw Solana transactions with optional balances, rewards, logs, and instruction context. Filter by program, account, or time range to inspect specific on-chain activity.
Instructions
Query raw Solana transactions with optional balances, rewards, logs, and instruction context.
COMMON USER ASKS:
Recent Solana transactions
Filter by program
WHEN TO USE:
You need raw Solana transaction records.
You want Solana-specific filters or include flags that convenience tools do not expose.
DON'T USE:
You only want recent activity or a compact network summary.
EXAMPLES:
Recent Solana transactions: {"network":"solana-mainnet","timeframe":"1h","limit":20}
Filter by program: {"network":"solana-mainnet","timeframe":"1h","program_id":["TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"],"limit":20}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max transactions to return (default: 50, max: 200) | |
| cursor | No | Continuation cursor from a previous response | |
| network | No | Network name or alias. Optional when continuing with cursor. | |
| to_block | No | Ending slot number | |
| fee_payer | No | Fee payer addresses | |
| timeframe | No | Time range (e.g., '1h', '24h'). Alternative to from_block/to_block. | |
| from_block | No | Starting slot number (use this OR timeframe) | |
| include_logs | No | Include program logs | |
| to_timestamp | No | Ending timestamp. Accepts Unix seconds, Unix milliseconds, ISO datetime, or relative input like "now". | |
| finalized_only | No | Only query finalized slots | |
| from_timestamp | No | Starting timestamp. Accepts Unix seconds, Unix milliseconds, ISO datetime, or relative input like "1h ago". | |
| include_rewards | No | Include block rewards (validator staking rewards). Filter by pubkey using mentions_account. | |
| response_format | No | Response format: defaults to 'compact' for chat-friendly output, or stays 'full' when inline instruction, balance, log, or reward context is requested. Use 'summary' for aggregate stats. | |
| include_balances | No | Include SOL balance changes | |
| mentions_account | No | Accounts mentioned anywhere in the transaction | |
| include_instructions | No | Include instruction data | |
| include_token_balances | No | Include SPL token balance changes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| _ui | No | Optional chart, table, and follow-up presentation metadata. | |
| _llm | No | Hints that help an AI client locate the primary evidence. | |
| _meta | No | Network, block range, timing, and row-count metadata. | |
| error | No | Structured failure details when the tool cannot complete the request. | |
| items | No | Primary result rows when the tool returns a list. | |
| value | No | Primary result when the tool returns a scalar value. | |
| answer | No | Concise answer grounded in the returned blockchain data. | |
| _notice | No | Important limitation or truncation notice. | |
| display | No | Plain-language labels for presenting the result. | |
| _notices | No | Important limitations or truncation notices. | |
| _summary | No | Human-readable summary of the result. | |
| _coverage | No | Completeness of the requested window and result set. | |
| _evidence | No | Replayable arguments, exact-data digest, row count, and completeness receipt. | |
| _ordering | No | Ordering guarantees for the returned data. | |
| _execution | No | Bounded execution and scan details. | |
| _freshness | No | Freshness and finality information for the returned data. | |
| next_steps | No | Safe follow-up actions and continuation guidance. | |
| _pagination | No | Pagination state and an optional continuation cursor. | |
| investigation | No | Evidence paths, useful pivots, and result limitations. | |
| pipes_handoff | No | Optional SQD Pipes guidance for custom data needs. | |
| _tool_contract | No | Tool identity, intent, and supported blockchain families. |