# Blocknative

Blocknative provides real-time mempool monitoring and transaction management tools for public blockchains.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `BLOCKNATIVE`
- **Version:** 20260227_00

## Tools

### Configure Mempool Filters

**Slug:** `BLOCKNATIVE_CONFIGURE_FILTERS`

Tool to configure filters and ABI decoding for Ethereum mempool transactions. Use after establishing a Blocknative WebSocket connection to set up event filters and decoding.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `config` | object | Yes | Nested object defining scope, filters, ABI decode and watch settings. |
| `eventCode` | string | Yes | Must be the literal string 'put'. |
| `categoryCode` | string | Yes | Must be the literal string 'configs'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Gas Price Distribution

**Slug:** `BLOCKNATIVE_GET_GAS_DISTRIBUTION`

Tool to retrieve the current mempool gas price distribution breakdown. Use when analyzing gas price trends or preparing fee strategies.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Gas Oracles

**Slug:** `BLOCKNATIVE_GET_GAS_ORACLES`

Tool to retrieve metadata on supported gas oracles per chain. Use when you need to dynamically discover all available on-chain gas estimation oracles across networks.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Gas Prices

**Slug:** `BLOCKNATIVE_GET_GAS_PRICES`

Tool to fetch gas price estimates for specific inclusion probabilities. Use when you need gas price ranges for the next block or next ~10 seconds.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `system` | string | No | The chain ecosystem (e.g., 'ethereum', 'story', 'polygon'). |
| `chainid` | integer | No | The network chain ID. Default is 1 (Ethereum Mainnet). |
| `network` | string | No | The specific network within the system (e.g., 'mainnet', 'sepolia'). |
| `confidenceLevels` | array | No | Up to 5 custom confidence levels to override defaults (99,95,90,80,70). For Ethereum Mainnet, values 1-99; for other chains, select from (99,95,90,80,70,50). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Supported Chains

**Slug:** `BLOCKNATIVE_GET_SUPPORTED_CHAINS`

Tool to retrieve supported chains metadata. Use when discovering available networks for Blocknative gas services.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Base Fee Estimates

**Slug:** `BLOCKNATIVE_PREDICTION_API_BASEFEE_ESTIMATES`

Get real-time gas fee predictions for Ethereum mainnet's next 5 blocks. Returns base fee, blob base fee, and priority fee estimates at multiple confidence levels (99% and 50%). Essential for optimizing transaction costs and timing. Predictions include current block context (block number, time since last block) and estimated fees in gwei.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Subscribe Multichain

**Slug:** `BLOCKNATIVE_SUBSCRIBE_MULTICHAIN`

Generate WebSocket connection details to subscribe to real-time blockchain events (transactions or account activity) across multiple chains via Blocknative's Multichain API. Returns the WebSocket URL and subscription message payload needed to establish the connection and start receiving event notifications for a specific transaction hash or account address on any supported blockchain.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Transaction hash or account address to subscribe to (hex string starting with '0x'). |
| `abi` | array | No | (Account only) Optional JSON ABI array to decode contract input data on account events. |
| `type` | string ("transaction" | "account") | Yes | Type of subscription: 'transaction' for transaction events, 'account' for address events. |
| `chainId` | string | Yes | Hex-encoded chain ID, e.g. '0x1' for Ethereum Mainnet. |
| `filters` | array | No | (Account only) Optional array of JSQL filter expressions to apply to account events. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Subscribe Transaction Hash

**Slug:** `BLOCKNATIVE_SUBSCRIBE_TRANSACTION_HASH`

Tool to subscribe to transaction state change events of an Ethereum transaction hash. Use after establishing a Blocknative WebSocket connection to prepare the subscription message.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hash` | string | Yes | Ethereum transaction hash to monitor (must be in format: 0x followed by 64 hexadecimal characters). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Unsubscribe Multichain

**Slug:** `BLOCKNATIVE_UNSUBSCRIBE_MULTICHAIN`

Tool to unsubscribe from events across multiple chains using the Multichain SDK. Use after stopping monitoring of an address or transaction to clean up resources, e.g., call: blocknative.unsubscribe({ id: '0x..', chainId: '0x1' }).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Transaction hash or account address to stop monitoring across chains. |
| `chainId` | string | Yes | Hex-encoded chain ID where the subscription exists, e.g. '0x1'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Unsubscribe Transaction Hash

**Slug:** `BLOCKNATIVE_UNSUBSCRIBE_TRANSACTION_HASH`

Tool to unsubscribe from transaction state change events for an Ethereum transaction hash. Use after establishing a Blocknative WebSocket connection to prepare the unsubscription message.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hash` | string | Yes | Ethereum transaction hash to unsubscribe from. Must be a valid 66-character hex string starting with '0x' (e.g., '0x0b4c94c414f71ddd5e7a625fcaa83ff1f93e9a7ca37e0f577b488ac8fd786655'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |