API Reference
Interactive API documentation for Axol API. Explore all 592 endpoints across 25+ blockchain networks.
Interactive Documentation
Explore our comprehensive API documentation with multiple interfaces:
- Interactive API Explorer: /api - Full-featured Scalar interface
- Swagger UI: https://api.axol.io/docs - Traditional OpenAPI interface
- ReDoc: https://api.axol.io/redoc - Clean documentation view
- OpenAPI Spec: /openapi.json - Raw specification file
Quick Start
- Get your API key from the Axol Dashboard
- Include it in the Authorization header:
Bearer YOUR_API_KEY - Start making requests to any of the 592 available endpoints
API Specifications
- Version: 1.0.0
- Endpoints: 592 fully documented endpoints
- Networks: 25+ blockchain networks supported
- Authentication: Bearer Token (JWT)
- Base URL:
https://api.axol.io
Key Features
- Multi-chain support including EVM and non-EVM networks
- Real-time data with intelligent caching (90%+ performance improvement)
- Enterprise security with zero high/medium severity vulnerabilities
- High performance with sub-50ms response times
Supported Networks
EVM Compatible (12 chains)
- Layer 1: Ethereum, Polygon
- Layer 2: Arbitrum, Optimism, Base
- Sidechains: Gnosis, Avalanche
- Emerging: Unichain
Alternative Protocols (15+ chains)
- Bitcoin: Bitcoin (native support)
- Solana: Solana (high-performance)
- Cosmos Ecosystem: Celestia, dYdX, Osmosis, Sei, Babylon
- Other L1s: Polkadot, Starknet, Sui, NEAR, Aptos
- Privacy: Aztec Network
- Cross-chain: Elixir, LavaNet, Across Protocol
Performance Metrics
- Health endpoint: 6.54ms average (target: under 50ms) - PASSING
- Throughput: 152 req/s (target: over 100 req/s) - PASSING
- Cache hit rate: 90%+ with multi-tier caching
- Uptime: 99.9% SLA with global redundancy
Rate Limits
Axol uses Compute Unit (CU) based rate limiting for fair pricing:
| Tier | Monthly CU Pool | Throughput (CUPs) | Trace CU Pool |
|---|---|---|---|
| Starter | 400M CUs | 50 CUs/sec | No access |
| Growth | 2B CUs | 330 CUs/sec | 100M CUs |
| Scale | 12B CUs | 1,250 CUs/sec | 1B CUs |
| Enterprise | Custom | Custom | Custom |
What is a CU? A Compute Unit measures computational resources consumed by a request. Simple calls like eth_blockNumber cost ~10 CUs, while complex trace methods cost 1,000-50,000 CUs.
See Pricing for full CU cost breakdown by method.
Authentication
All API requests require a Bearer token in the Authorization header:
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.axol.io/api/v1/health
Example Requests
Health Check
curl https://api.axol.io/api/v1/health
Get Ethereum Balance
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.axol.io/api/v1/blockchain/ethereum/balance/0x123...
Get Gas Prices
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.axol.io/api/v1/gas/prices?chains=ethereum,polygon
SDKs
- Python:
pip install axol-api - TypeScript/JavaScript:
npm install @axol/api - Documentation: SDK Documentation
Support
- Documentation: https://docs.axol.io
- Status Page: https://status.axol.io
- Support: https://axol.io/support