Find Solana program activity
portal_solana_query_instructionsRead-only
Query Solana program and account instructions with filters for program IDs, discriminators, and time ranges to inspect Token Program, Jupiter, and Anchor activity.
Instructions
Query raw Solana instructions with program and account filters.
COMMON USER ASKS:
Token Program instructions
WHEN TO USE:
You need program-level or account-level instruction activity.
You want to inspect Token Program, Jupiter, System Program, or Anchor discriminator activity.
DON'T USE:
You only need transaction-level activity and not individual instructions.
EXAMPLES:
Token Program instructions: {"network":"solana-mainnet","timeframe":"1h","program_id":["TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"],"limit":20}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| a0 | No | Account at index 0. You can pass a single string or an array. | |
| a1 | No | Account at index 1. You can pass a single string or an array. | |
| a2 | No | Account at index 2. You can pass a single string or an array. | |
| a3 | No | Account at index 3. You can pass a single string or an array. | |
| a4 | No | Account at index 4. You can pass a single string or an array. | |
| a5 | No | Account at index 5. You can pass a single string or an array. | |
| a6 | No | Account at index 6. You can pass a single string or an array. | |
| a7 | No | Account at index 7. You can pass a single string or an array. | |
| a8 | No | Account at index 8. You can pass a single string or an array. | |
| a9 | No | Account at index 9. You can pass a single string or an array. | |
| d1 | No | 1-byte discriminator filter (0x-prefixed hex). You can pass a single string or an array. | |
| d2 | No | 2-byte discriminator filter (0x-prefixed hex). You can pass a single string or an array. | |
| d4 | No | 4-byte discriminator filter (0x-prefixed hex). You can pass a single string or an array. | |
| d8 | No | 8-byte discriminator filter - Anchor (0x-prefixed hex). You can pass a single string or an array. | |
| a10 | No | Account at index 10. You can pass a single string or an array. | |
| a11 | No | Account at index 11. You can pass a single string or an array. | |
| a12 | No | Account at index 12. You can pass a single string or an array. | |
| a13 | No | Account at index 13. You can pass a single string or an array. | |
| a14 | No | Account at index 14. You can pass a single string or an array. | |
| a15 | No | Account at index 15. You can pass a single string or an array. | |
| limit | No | Max instructions | |
| 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. Keep ranges reasonable for performance. | |
| timeframe | No | Time range (e.g., '1h', '24h'). Alternative to from_block/to_block. Solana slots are ~400ms. | |
| from_block | No | Starting slot number (use this OR timeframe) | |
| program_id | No | Program IDs. You can pass a single string or an array. | |
| include_logs | No | Include program logs | |
| is_committed | No | Only committed transactions | |
| 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". | |
| mentions_account | No | Accounts mentioned anywhere in the instruction. You can pass a single string or an array. | |
| include_transaction | No | Include transaction data | |
| transaction_fee_payer | No | Fee payer filter. You can pass a single string or an array. | |
| include_inner_instructions | No | Include inner (CPI) instructions | |
| include_transaction_balances | No | Include SOL balance changes | |
| include_transaction_instructions | No | Include all instructions from the parent transaction (sibling instructions) | |
| include_transaction_token_balances | No | Include token balance changes |
Output Schema
TableJSON 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. |