Skip to main content
Blocknative logo
  • Category: developer tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 10
  • Triggers: 0
  • Slug: BLOCKNATIVE
  • Version: 20261101_00

Tools

Slug: BLOCKNATIVE_CONFIGURE_FILTERSSimulate configuration of Ethereum mempool filters and ABI decoding, returning an acknowledgment containing the supplied configuration. No configuration is sent to Blocknative.

Input Parameters

object
required
Nested object defining scope, filters, ABI decode and watch settings.
string
required
Must be the literal string ‘put’.
string
required
Must be the literal string ‘configs’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOCKNATIVE_GET_GAS_DISTRIBUTIONTool to retrieve the current mempool gas price distribution breakdown. Use when analyzing gas price trends or preparing fee strategies.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOCKNATIVE_GET_GAS_ORACLESTool 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOCKNATIVE_GET_GAS_PRICESTool 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

string
The chain ecosystem (e.g., ‘ethereum’, ‘story’, ‘polygon’).
integer
The network chain ID. Default is 1 (Ethereum Mainnet).
string
The specific network within the system (e.g., ‘mainnet’, ‘sepolia’).
array
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOCKNATIVE_GET_SUPPORTED_CHAINSTool to retrieve supported chains metadata. Use when discovering available networks for Blocknative gas services.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOCKNATIVE_PREDICTION_API_BASEFEE_ESTIMATESGet 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOCKNATIVE_SUBSCRIBE_MULTICHAINGenerate 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

string
required
Transaction hash or account address to subscribe to (hex string starting with ‘0x’).
array
(Account only) Optional JSON ABI array to decode contract input data on account events.
string ("transaction" | "account")
required
Type of subscription: ‘transaction’ for transaction events, ‘account’ for address events.
string
required
Hex-encoded chain ID, e.g. ‘0x1’ for Ethereum Mainnet.
array
(Account only) Optional array of JSQL filter expressions to apply to account events.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOCKNATIVE_SUBSCRIBE_TRANSACTION_HASHTool 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

string
required
Ethereum transaction hash to monitor (must be in format: 0x followed by 64 hexadecimal characters).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOCKNATIVE_UNSUBSCRIBE_MULTICHAINGenerate a JavaScript Multichain SDK unsubscribe call for an account address or transaction hash on a specified chain. The generated call must be executed to request unsubscription.

Input Parameters

string
required
Transaction hash or account address to stop monitoring across chains.
string
required
Hex-encoded chain ID where the subscription exists, e.g. ‘0x1’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOCKNATIVE_UNSUBSCRIBE_TRANSACTION_HASHTool 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

string
required
Ethereum transaction hash to unsubscribe from. Must be a valid 66-character hex string starting with ‘0x’ (e.g., ‘0x0b4c94c414f71ddd5e7a625fcaa83ff1f93e9a7ca37e0f577b488ac8fd786655’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not