portal_bitcoin_query_transactions
Query raw Bitcoin transactions with optional inline inputs and outputs. Filter by block range or timeframe, up to 200 transactions.
Instructions
Query raw Bitcoin transactions and optionally attach inputs and outputs inline.
COMMON USER ASKS:
Recent Bitcoin transactions
Attach inputs and outputs
WHEN TO USE:
You need raw Bitcoin transaction records.
You want the UTXO envelope without switching to separate input/output tools.
DON'T USE:
You only need a quick wallet or network summary.
EXAMPLES:
Recent Bitcoin transactions: {"network":"bitcoin-mainnet","timeframe":"1h","limit":20}
Attach inputs and outputs: {"network":"bitcoin-mainnet","timeframe":"1h","include_inputs":true,"include_outputs":true,"limit":10}
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 (default: bitcoin-mainnet). Optional when continuing with cursor. | |
| to_block | No | Ending block number | |
| timeframe | No | Time range (e.g., '1h', '24h'). Alternative to from_block/to_block. | |
| from_block | No | Starting block number | |
| to_timestamp | No | Ending timestamp. Accepts Unix seconds, Unix milliseconds, ISO datetime, or relative input like "now". | |
| finalized_only | No | Only query finalized blocks | |
| from_timestamp | No | Starting timestamp. Accepts Unix seconds, Unix milliseconds, ISO datetime, or relative input like "1h ago". | |
| include_inputs | No | Attach transaction inputs inline | |
| include_outputs | No | Attach transaction outputs inline | |
| response_format | No | Response format: defaults to 'compact' for chat-friendly output. Compact mode keeps inline inputs and outputs in a smaller shape when requested. |