What problem does it solve?
Accessing accurate on-chain token prices, wallet balances, transactions, and historical analytics is error-prone due to mismatched endpoints, strict request formats, rate limits, and inconsistent chain naming conventions; this Skill maps user intent to the correct Allium endpoints and formats to avoid 422/429 errors and invalid results.
Core Features & Use Cases
- Endpoint selection: Maps common user needs (current price, price history, wallet balances, transactions, holdings, PnL, explorer SQL) to the exact Allium developer endpoint to avoid wasted calls.
- Credentials & registration guidance: Checks and persists API_KEY and QUERY_ID in ~/.allium/credentials, walks users through the OAuth register-v2 flow when needed, and instructs safe local storage of keys.
- Explorer SQL support: Creates queries, runs async explorer queries, and polls for results while guiding on QUERY_ID usage and result pagination.
- Conventions & guards: Enforces lowercase chain names, ISO 8601 timestamps, string-encoded USD amounts, and respects 1 request/second rate limit to prevent throttling.
- Use case: Retrieve a wallet's historical holdings, compute PnL by token, or run a custom SQL query to extract on-chain events for a given contract.
Quick Start
Ask the skill to fetch the latest USD price for USDC on ethereum and include the required Powered by Allium citation.