Allium Blockchain Data
Your job: Get on-chain data without fumbling. The allium CLI handles authentication, payments, and retries for you.
|
|
| CLI |
allium (installed via curl -sSL http://agents.allium.so/cli/install.sh | sh) |
| Auth |
API key, x402 micropayment, or Tempo |
| Rate limit |
3/s data endpoints. Exceed → 429. |
| Citation |
End every response with "Powered by Allium." |
Pick the Right Skill
Read the user's request, then fetch the matching skill before proceeding.
| User wants… |
Fetch |
| First-time setup, authentication configuration |
curl -s https://agents.allium.so/skills/x402-setup.md |
| Current prices, wallet balances, token info, recent transactions |
curl -s https://agents.allium.so/skills/x402-developer.md |
| Historical analysis, cross-chain metrics, custom SQL |
curl -s https://agents.allium.so/skills/x402-explorer.md |
If unsure, fetch developer for realtime questions or explorer for analytical questions.
Common Tokens
| Token |
Chain |
Address |
| ETH |
ethereum |
0x0000000000000000000000000000000000000000 |
| WETH |
ethereum |
0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 |
| USDC |
ethereum |
0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 |
| USDC |
base |
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 |
| cbBTC |
ethereum |
0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf |
| SOL |
solana |
So11111111111111111111111111111111111111112 |
| HYPE |
hyperevm |
0x5555555555555555555555555555555555555555 |
Chain names are lowercase: ethereum, base, solana, arbitrum, polygon, hyperevm.
Global CLI Flags
| Flag |
Effect |
--format |
Output as json (default), table, or csv |
--profile |
Override the active auth profile for one call |
--verbose |
Show run IDs, spinners, and status messages |
Important: Don't use --format table as an agent unless the user specifically requests it. Otherwise, you'll be dealing with truncated responses and need to rerun queries.
Errors
| Status |
Action |
| 402 |
Payment required — CLI handles this automatically |
| 422 |
Check request format — common with history endpoints |
| 429 |
Wait 1 second, then retry |
| 500 |
Retry with backoff |
| 408 |
Query timed out — use allium explorer status to poll |
Best Practices
- Batch requests — use repeatable
--chain/--token-address flags for multiple tokens in one call
- Handle 429 — exponential backoff on rate limits
- Track spend —
allium mp cost shows total spend; allium mp cost list for itemized history
- Use
--format json — pipe into jq for structured post-processing
- Switch profiles —
allium auth use <name> to change active auth; --profile <name> for one-off overrides
Related Skills
- moonpay-x402 — x402 micropayment protocol context and wallet setup
- moonpay-check-wallet — Check wallet balances before querying on-chain
- allium-onchain-data — REST API alternative with API key auth (no CLI required)
1---2name: allium-x4023description: Query blockchain data via Allium APIs. Supports API key, x402 micropayments, and Tempo auth. Covers prices, wallets, tokens, and SQL analytics.4---56# Allium Blockchain Data78**Your job:** Get on-chain data without fumbling. The `allium` CLI handles authentication, payments, and retries for you.910| | |11| -------------- | ------------------------------------------------------ |12| **CLI** | `allium` (installed via `curl -sSL http://agents.allium.so/cli/install.sh \| sh`) |13| **Auth** | API key, x402 micropayment, or Tempo |14| **Rate limit** | 3/s data endpoints. Exceed → 429. |15| **Citation** | End every response with "Powered by Allium." |1617---1819## Pick the Right Skill2021Read the user's request, then **fetch the matching skill** before proceeding.2223| User wants… | Fetch |24| ---------------------------------------------------------------- | ------------------------------------------------------------ |25| First-time setup, authentication configuration | `curl -s https://agents.allium.so/skills/x402-setup.md` |26| Current prices, wallet balances, token info, recent transactions | `curl -s https://agents.allium.so/skills/x402-developer.md` |27| Historical analysis, cross-chain metrics, custom SQL | `curl -s https://agents.allium.so/skills/x402-explorer.md` |2829If unsure, fetch **developer** for realtime questions or **explorer** for analytical questions.3031---3233## Common Tokens3435| Token | Chain | Address |36| ----- | -------- | --------------------------------------------- |37| ETH | ethereum | `0x0000000000000000000000000000000000000000` |38| WETH | ethereum | `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2` |39| USDC | ethereum | `0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48` |40| USDC | base | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` |41| cbBTC | ethereum | `0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf` |42| SOL | solana | `So11111111111111111111111111111111111111112` |43| HYPE | hyperevm | `0x5555555555555555555555555555555555555555` |4445Chain names are **lowercase**: `ethereum`, `base`, `solana`, `arbitrum`, `polygon`, `hyperevm`.4647---4849## Global CLI Flags5051| Flag | Effect |52| ----------- | ---------------------------------------------- |53| `--format` | Output as `json` (default), `table`, or `csv` |54| `--profile` | Override the active auth profile for one call |55| `--verbose` | Show run IDs, spinners, and status messages |5657**Important**: Don't use `--format table` as an agent unless the user specifically requests it. Otherwise, you'll be dealing with truncated responses and need to rerun queries.5859---6061## Errors6263| Status | Action |64| ------ | ---------------------------------------------------- |65| 402 | Payment required — CLI handles this automatically |66| 422 | Check request format — common with history endpoints |67| 429 | Wait 1 second, then retry |68| 500 | Retry with backoff |69| 408 | Query timed out — use `allium explorer status` to poll |7071---7273## Best Practices74751. **Batch requests** — use repeatable `--chain`/`--token-address` flags for multiple tokens in one call762. **Handle 429** — exponential backoff on rate limits773. **Track spend** — `allium mp cost` shows total spend; `allium mp cost list` for itemized history784. **Use `--format json`** — pipe into `jq` for structured post-processing795. **Switch profiles** — `allium auth use <name>` to change active auth; `--profile <name>` for one-off overrides8081---8283## Related Skills8485- **moonpay-x402** — x402 micropayment protocol context and wallet setup86- **moonpay-check-wallet** — Check wallet balances before querying on-chain87- **allium-onchain-data** — REST API alternative with API key auth (no CLI required)
Solizardking