https://agents.allium.so. No API key needed — pay with USDC using Tempo MPP or x402. All calls are priced individually. No subscription, no minimum spend.
Install allium-cli
CLI commands require allium-cli:Supported Chains Discovery
Check which chains each endpoint supports. This endpoint is free — no payment required.Realtime API
Prices
| CLI Command | Method | Endpoint | Cost | Description |
|---|---|---|---|---|
allium realtime prices latest | POST | /api/v1/developer/prices | $0.02 | Get latest token prices |
allium realtime prices at-timestamp | POST | /api/v1/developer/prices/at-timestamp | $0.02 | Get token prices at a specific time |
allium realtime prices history | POST | /api/v1/developer/prices/history | $0.02 | Get historical token price series |
allium realtime prices stats | POST | /api/v1/developer/prices/stats | $0.02 | Get token price statistics |
Tokens
| CLI Command | Method | Endpoint | Cost | Description |
|---|---|---|---|---|
allium realtime tokens search | GET | /api/v1/developer/tokens/search | $0.03 | Search tokens by name or symbol |
allium realtime tokens chain-address | POST | /api/v1/developer/tokens/chain-address | $0.02 | Look up tokens by chain and address |
allium realtime tokens list | GET | /api/v1/developer/tokens | $0.03 | List all supported tokens |
Wallets
| CLI Command | Method | Endpoint | Cost | Description |
|---|---|---|---|---|
allium realtime balances latest | POST | /api/v1/developer/wallet/balances | $0.03 | Get current wallet token balances |
allium realtime balances history | POST | /api/v1/developer/wallet/balances/history | $0.03 | Get historical wallet balances |
allium realtime transactions | POST | /api/v1/developer/wallet/transactions | $0.03 | Get wallet transaction history |
allium realtime pnl | POST | /api/v1/developer/wallet/pnl | $0.03 | Get wallet profit and loss |
Explorer API
The Explorer API is also available via machine payments. Therun-sql endpoint uses machine payments auth directly. The remaining Explorer endpoints (run, status, results) require API key authentication.
| CLI Command | Method | Endpoint | Cost | Auth | Description |
|---|---|---|---|---|---|
allium explorer run-sql | POST | /api/v1/explorer/queries/run-async | $0.01 | Machine payments | Submit raw SQL for async execution |
allium explorer run | POST | /api/v1/explorer/queries/{query_id}/run-async | $0.01 | API key | Run a saved query asynchronously |
allium explorer status | GET | /api/v1/explorer/query-runs/{run_id}/status | $0.01 | API key | Check status of a query run |
allium explorer results | GET | /api/v1/explorer/query-runs/{run_id}/results | dynamic | API key | Fetch results of a completed query |
Supported Networks
| Protocol | Network | USDC Address |
|---|---|---|
| Tempo MPP | Tempo (mainnet) | 0x20c000000000000000000000b9537d11c60e8b50 |
| x402 | Base (mainnet) | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 |
| x402 | Solana (mainnet) | EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v |
Rate Limits
Two independent rate limit buckets per wallet. You can max out both simultaneously.| Bucket | Endpoints | Limit |
|---|---|---|
| Data | All /developer/ endpoints | 3 requests/second |
| Docs | All /docs/ endpoints | 5 requests/second |
429. Wait 1 second before retrying.
Error Codes
| Status | Meaning | What to Do |
|---|---|---|
| 400 | Bad request | Check JSON syntax |
| 402 | Payment required | Sign the payment and retry (handled automatically by Tempo MPP) |
| 422 | Validation failed | Check request format |
| 429 | Rate limited | Back off for 1 second |
| 500 | Server error | Retry with exponential backoff |