allium-onchain-data

Query blockchain data via Allium APIs for prices, balances, and transactions.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/Drock91/ows-hackathon --skill allium-onchain-data-drock91
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: allium-onchain-data
Source: https://github.com/Drock91/ows-hackathon/tree/main/.agents/skills/allium-onchain-data
Command: npx skills add https://github.com/Drock91/ows-hackathon --skill allium-onchain-data-drock91

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

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.

Frequently Asked Questions about allium-onchain-data

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fetch reliable on-chain wallet balances and token prices across multiple blockchains?

To fetch on-chain token prices and wallet balances across multiple blockchains, query blockchain data via Allium APIs, which map user intent to correct endpoints for accurate current price lookups, wallet balances, and historical analytics. You must authenticate using an X-API-KEY.

Do I need an API key to query on-chain data and run Explorer SQL calls?

Yes, you need an X-API-KEY to authenticate on-chain data queries and run Explorer SQL calls. The Skill persists your API_KEY and QUERY_ID in ~/.allium/credentials and walks you through the OAuth register-v2 flow when needed.

What is the rate limit for fetching historical crypto analytics and on-chain transaction data?

The rate limit for fetching historical crypto analytics and on-chain transaction data is 1 request per second. The Skill respects this limit to prevent throttling and avoid 429 errors while returning ISO 8601 timestamps with string-encoded USD amounts.

Why does my on-chain API request return a 422 error when querying token holdings?

Your on-chain API request returns a 422 error when querying token holdings due to mismatched endpoints, strict request formats, or inconsistent chain naming conventions. The Skill enforces lowercase chain names and correct formats to avoid invalid results.

Can I compute wallet PnL by token and run async custom SQL queries for on-chain events?

Yes, you can compute wallet PnL by token and run async custom SQL queries for on-chain events. The Skill creates queries, runs async Explorer SQL calls using a QUERY_ID, polls for results, and paginates the extracted contract data.

How do I get accurate historical price history for crypto tokens using an Explorer API?

To get accurate historical price history for crypto tokens using an Explorer API, the Skill maps your price history intent to the exact Allium developer endpoint, preventing wasted calls and returning USD amounts as string-encoded values with ISO 8601 timestamps.