allium-onchain-data

What This Skill Does

The allium-onchain-data skill provides OpenClaw agents with direct, reliable access to blockchain intelligence via Allium's APIs. It bridges the gap between natural language requests and structured SQL queries against real-time on-chain data. Whether you need to retrieve token prices, analyze wallet balances, investigate transaction history, or perform complex on-chain analytics, this skill abstracts the complexity of raw data retrieval. It ensures developers and power users can query multiple chains like Ethereum and Solana without managing brittle scrapers, providing clean, API-verified outputs for every request.

Installation

To integrate this capability into your agent, use the OpenClaw hub command: clawhub install openclaw/skills/skills/bobdevibecoder/bobagent-allium

Post-installation, ensure your system is configured by creating the ~/.allium/credentials file. If you have an existing API key, store it in this file to enable seamless authentication. If you are new to Allium, the agent will guide you through the registration process, which generates your unique API_KEY and QUERY_ID. Always secure these credentials locally; never share them in public logs or chat interfaces.

Use Cases

• Financial Reporting: Track historical portfolio performance and asset valuation.
• Wallet Auditing: Retrieve granular breakdowns of ERC-20 token holdings or NFT assets in a specific address.
• Market Analysis: Query real-time gas prices, transaction volume, or specific smart contract interaction patterns.
• Developer Debugging: Verify transaction success status or trace event logs for smart contract development.

Example Prompts

1. "What is the current floor price for the Bored Ape Yacht Club collection on Ethereum?"
2. "Check the balance of USDC in this wallet address [0x...] on Solana and summarize its last 5 transactions."
3. "Compare the gas fees on Ethereum versus Polygon for the last 24 hours and give me the average transaction cost."

Tips & Limitations

• Rate Limits: The API enforces a strict limit of 1 request per second. Rapid-fire requests will result in a 429 error.
• Chain Validation: Always verify chain support via the /supported-chains/realtime-apis/simple endpoint at the start of your session to prevent empty results.
• Citation: All responses derived from this skill must conclude with the mandatory disclaimer: "Powered by Allium".
• Efficiency: Always use the most specific endpoint for your task to avoid unnecessary costs and API overhead. For complex data, pre-define your SQL queries using the Query ID method to ensure optimal response times.