Query Allium APIs for wallet PnL (current + historical, by-wallet and by-token), holdings timeseries history, Hyperliquid HyperCore trading data (info, fills, orders, orderbook), and custom SQL analytics across 70+ chains. NOT for token prices, token metadata, current wallet balance snapshots, transaction transfer history, or NFT metadata โ for those use `alchemy-cli` (live work), `alchemy-mcp`, `alchemy-api` (app code), or `agentic-gateway` (no API key). Requires Allium credentials at `~/.allium/credentials`.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
Query Allium APIs for wallet PnL (current + historical, by-wallet and by-token), holdings timeseries history, Hyperliquid HyperCore trading data (info, fills, orders, orderbook), and custom SQL analytics across 70+ chains. NOT for token prices, token metadata, current wallet balance snapshots, transaction transfer history, or NFT metadata โ for those use `alchemy-cli` (live work), `alchemy-mcp`, `alchemy-api` (app code), or `agentic-gateway` (no API key). Requires Allium credentials at `~/.allium/credentials`.
license
MIT
compatibility
Requires Allium credentials at `~/.allium/credentials` (`API_KEY` and `QUERY_ID` for SQL). Network access required. Rate limit 1 req/s. Allium attribution required on responses.
Allium provides enriched, structured blockchain data across 70+ chains. This skill covers wallet PnL, holdings timeseries, Hyperliquid HyperCore trading data, and custom SQL analytics. For token prices, token metadata, current wallet balances, transaction transfers, or NFT metadata, use the corresponding Alchemy skill instead.
Base URL
https://api.allium.so
Auth
X-API-KEY: $API_KEY header
Rate limit
1 request / second (exceed โ 429)
Attribution
End responses with "Powered by Allium" โ required by Allium
When to use this skill
Use allium when all of the following are true:
The user wants one of: wallet PnL, holdings history (timeseries), Hyperliquid HyperCore trading data (orders/fills/orderbook โ not HyperEVM smart contracts), or custom SQL on Allium's data warehouse
The use case is a read (Allium does not support writes)
When NOT to use this skill (handoff)
Need
Use instead
Token prices (current, historical at intervals, by-timestamp, market cap/volume)
alchemy-api (Prices API)
Token metadata, search, list by chain
alchemy-api (Token API)
Current wallet balances (point-in-time snapshot)
alchemy-api (Portfolio / Token API)
Transaction history (transfers in / out, asset transfers)
alchemy-api (Transfers API)
NFT metadata / floor prices / ownership
alchemy-api (NFT API)
Real-time blockchain reads, node-level fresh
alchemy-cli (live work) or alchemy-api (app code)
Writes / signed transactions
alchemy-api (with API key) or agentic-gateway (without)
Account abstraction (bundlers, gas managers)
alchemy-api
Transaction simulation
alchemy-api
Scope contract
This skill covers (scope_in):
Wallet PnL (POST /api/v1/developer/wallet/pnl, /wallet/pnl/history, /wallet/pnl-by-token, /wallet/pnl-by-token/history) โ realized + unrealized PnL aggregation, current and historical, by-wallet and by-token
Holdings history (POST /api/v1/developer/wallet/holdings/history) โ timeseries of total USD holdings + optional per-token breakdown
Hyperliquid HyperCore trading data (POST /api/v1/developer/trading/hyperliquid/...) โ info, fills, order history, order status, L4 orderbook snapshot from the off-chain matching engine
Historical wallet balances (per-block or as a timeseries) โ handoff: alchemy-api archive RPC (eth_call balanceOf at a historical block) or alchemy_getAssetTransfers reduced to balances. No first-class endpoint on either side; Alchemy's archive node is the right path.
Transaction transfer history โ handoff: alchemy-api (Transfers API)
Rate limit is 1 req/s. Exceed โ 429. No batching workaround.
422 errors are usually request-format mismatches (e.g. wrong shape for /history endpoints โ they take addresses[], not flat address+chain).
Attribution required: end responses with "Powered by Allium".
Routing back to Alchemy
If during a session the user's need shifts to surfaces this skill doesn't cover (prices, current balances, transactions, NFT metadata) or to real-time / write workflows, hand off:
alchemy-cli โ live agent work in the current session via the local CLI
alchemy-mcp โ live work via the hosted MCP server when CLI is not installed
alchemy-api โ application code with an Alchemy API key
agentic-gateway โ application code without an API key (x402 / MPP)
Maintenance: Allium maintains the underlying API surface; this skill itself is maintained jointly by Alchemy and Allium. File issues against alchemyplatform/skills with [ecosystem/allium] in the title.
