API Reference
Complete API reference for both Cosmos SDK and EVM endpoints. Includes Cosmos RPC, REST API, WebSocket, gRPC, and Ethereum JSON-RPC methods with code examples, best practices, and Cosmos EVM implementation notes.
API Layers Overview
Integra exposes four API layers. Choose the right one for your use case.
EVM JSON-RPC
Familiar to Ethereum devs
Contract deployment, ethers.js, MetaMask, web3.js
mainnet.integralayer.com/evm
eth_*net_*web3_*Cosmos REST
Query chain state, governance, validators, balances
Governance proposals, validator info, bank balances, chain params
mainnet.integralayer.com/api
/cosmos/staking/*/cosmos/gov/*/cosmos/bank/*CometBFT RPC
Consensus-level queries, block/tx search, node status
Block exploration, transaction search, validator set, node health
mainnet.integralayer.com/rpc
/status/block/tx_search/validatorsgRPC
High-performance programmatic access (protobuf)
Backend services, high-throughput indexing, programmatic queries
Coming Soon
protobuf servicesWhich API should I use?
https://mainnet.integralayer.com/rpchttps://mainnet.integralayer.com/apiFor real-time CometBFT event subscriptions
Efficient binary protocol for Cosmos SDK queries, typically on port 9090
https://mainnet.integralayer.com/evmFor real-time EVM event subscriptions
Rate Limiting
Handle 429 errors gracefully with exponential backoff. Public endpoints may enforce rate limits to protect node resources.
eth_getLogs Pagination
Block range limited to 5,000-10,000 blocks per query. Split larger ranges into smaller chunks to avoid timeouts.
Filter Expiration
Filters are held in-memory for approximately 5 minutes and are lost on node restart. Re-create filters if they expire.
Gas Estimation
Integra uses binary search for gas estimation, which differs from standard EVM estimation. Always add a buffer to estimated gas values.
Instant Finality
No reorgs on Integra. One confirmation is final with approximately 5-second block times. No need to wait for multiple confirmations.
Archive Nodes
Transaction logs and blooms may not be persisted after chain upgrades. Historical data queries may require an archive node.
Revert Reasons
Nodes do not store failure reasons for reverted transactions. Historical replay to determine revert reasons requires an archive node.
Integra runs the EVM as a Cosmos SDK module. There are several behavioral differences from standard Ethereum nodes:
- effectiveGasPrice: Gas price behavior may differ from standard Ethereum. Integra uses minimal gas fees (~1 gwei).
- Receipt fields: Transaction receipts may not include all standard Ethereum fields (e.g., no
receiptsRootin block headers). - Client implementations: Libraries like ethers.js may need minor adjustments. Use viem for best compatibility. See the EVM RPC tab for tested configurations.