https://agents.allium.so. No API key needed — authenticate with USDC on Base. All calls are priced individually and paid with USDC on Base. No subscription, no minimum spend.
Supported Chains Discovery
Check which chains each endpoint supports. This endpoint is free — no payment required.Realtime API
Prices
| Endpoint | Method | Price | Full Docs |
|---|---|---|---|
/api/v1/developer/prices | POST | $0.002 | Token Latest Price |
/api/v1/developer/prices/history | POST | $0.002 | Token Price History |
/api/v1/developer/prices/stats | POST | $0.002 | Token Price Stats |
/api/v1/developer/prices/at-timestamp | POST | $0.002 | Token Price at Timestamp |
Tokens
| Endpoint | Method | Price | Full Docs |
|---|---|---|---|
/api/v1/developer/tokens | GET | $0.003 | List Tokens |
/api/v1/developer/tokens/search | GET | $0.003 | Search Tokens |
/api/v1/developer/tokens/chain-address | POST | $0.002 | Get Tokens by Chain Address |
Wallets
| Endpoint | Method | Price | Full Docs |
|---|---|---|---|
/api/v1/developer/wallet/balances | POST | $0.003 | Latest Token Balances |
/api/v1/developer/wallet/balances/history | POST | $0.003 | Historical Token Balances |
/api/v1/developer/wallet/transactions | POST | $0.003 | Transactions |
/api/v1/developer/wallet/pnl | POST | $0.003 | Holdings PnL |
Docs
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/v1/docs/docs/browse | GET | $0.001 | Browse documentation hierarchy |
Supported Networks
Payments are accepted on two networks:| Network | USDC Address | Status |
|---|---|---|
| Base (mainnet) | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 | Production |
| Base Sepolia (testnet) | 0x036CbD53842c5426634e7929541eC2318f3dCF7e | Testing |
We’re currently offering free x402 access on Base Sepolia for a limited time. Use testnet USDC to try all endpoints at no cost — get free testnet USDC from Circle’s faucet.
Rate Limits
x402 uses 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 EIP-712 payment and retry (handled automatically by the Python client) |
| 422 | Validation failed | Check request format — see the Full Docs link for each endpoint |
| 429 | Rate limited | Back off for 1 second |
| 500 | Server error | Retry with exponential backoff |