Realtime data

Realtime tools wrap Allium’s Realtime APIs as MCP tool calls. They’re the fastest path to current and recent on-chain state: no schema discovery, no SQL, no query queue.

Call realtime_get_supported_chains once per session before any other realtime tool, and cache the result. It returns a map of endpoint path → supported chain names, and it’s the only realtime tool that doesn’t consume credits. Passing an unsupported chain gives you a silent empty result or an error.

Available tools

Discovery

Tool	Description
`realtime_get_supported_chains`	Which chains each realtime endpoint supports. Call once, cache it

Prices

Tool	Description
`realtime_token_latest_price`	Latest price for one or many token/chain pairs
`realtime_token_price_history`	Price history at a chosen time granularity
`realtime_token_price_stats`	Volume, high/low, price and volume change
`realtime_token_price_at_timestamp`	Price of a token at a specific timestamp

Wallets

Tool	Description
`realtime_latest_token_balances`	Latest fungible token balances across chains
`realtime_historical_token_balances`	Paginated historical balances over a time range
`realtime_transactions`	Rich transaction activity — activities, asset transfers, labels
`realtime_get_positions`	DeFi positions across protocols and chains

Holdings & PnL

Tool	Description
`realtime_holdings_history`	Historical aggregated USD holdings for one or more addresses
`realtime_holdings_pnl`	PnL for a wallet
`realtime_holdings_pnl_history`	Historical PnL for a wallet
`realtime_holdings_pnl_by_token`	PnL for a wallet, broken down to one token
`realtime_holdings_pnl_by_token_history`	Historical PnL for a wallet and token

Tokens & assets

Tool	Description
`realtime_list_tokens`	List tokens, optionally sorted by a field
`realtime_search_tokens`	Search tokens by query string
`realtime_get_tokens_by_chain_address`	Token details for given chain/address pairs
`realtime_list_assets`	List assets
`realtime_get_assets`	Get assets by ID, slug, or chain and address

Hyperliquid trading data has its own five tools — see Hyperliquid.

Every tool names its own docs

Each realtime tool’s description ends with a browse_docs path pointing at the REST endpoint’s full documentation — supported chains, edge cases, pagination, and response shape.

{
  "name": "browse_docs",
  "arguments": { "path": "api/developer/prices/token-latest-price.md" }
}

That’s the authoritative reference for parameters. The examples below cover the shape of a call, not every field.

Tool	Docs path
`realtime_token_latest_price`	`api/developer/prices/token-latest-price.md`
`realtime_token_price_history`	`api/developer/prices/token-price-history.md`
`realtime_token_price_stats`	`api/developer/prices/token-price-stats.md`
`realtime_token_price_at_timestamp`	`api/developer/prices/token-price-at-timestamp.md`
`realtime_latest_token_balances`	`api/developer/wallets/latest-token-balances.md`
`realtime_historical_token_balances`	`api/developer/wallets/historical-token-balances.md`
`realtime_transactions`	`api/developer/wallets/transactions.md`
`realtime_get_positions`	`api/developer/defi-positions/get-positions.md`
`realtime_holdings_history`	`api/developer/holdings/holdings-history.md`
`realtime_holdings_pnl`	`api/developer/holdings/holdings-pnl.md`
`realtime_holdings_pnl_history`	`api/developer/holdings/holdings-pnl-history.md`
`realtime_holdings_pnl_by_token`	`api/developer/holdings/holdings-pnl-by-token.md`
`realtime_holdings_pnl_by_token_history`	`api/developer/holdings/holdings-pnl-by-token-history.md`
`realtime_list_tokens`	`api/developer/tokens/list-tokens.md`
`realtime_search_tokens`	`api/developer/tokens/search-tokens.md`
`realtime_get_tokens_by_chain_address`	`api/developer/tokens/get-tokens-by-chain-address.md`
`realtime_list_assets`	`api/developer/assets/list-assets.md`
`realtime_get_assets`	`api/developer/assets/get-assets.md`

Batching

Most realtime tools take a list of targets in one call, but the field name isn’t the same everywhere — check the tool’s input schema, or this table:

Batch field	Tools
`payloads`	`realtime_token_latest_price`, `realtime_get_tokens_by_chain_address`
`addresses`	price history, price stats, price at timestamp, latest and historical balances, transactions, holdings history, all four PnL tools
`payload`	`realtime_get_positions`
`requests`	`realtime_get_assets`

Tool usage

Latest prices

One tool handles single and batch lookups — pass one entry or many in payloads.

{
  "name": "realtime_token_latest_price",
  "arguments": {
    "payloads": [
      { "token_address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "chain": "ethereum" },
      { "token_address": "So11111111111111111111111111111111111111112", "chain": "solana" }
    ],
    "with_liquidity_info": true
  }
}

with_liquidity_info: true adds total_liquidity_usd. See token liquidity filtering for when that matters.

Price history

{
  "name": "realtime_token_price_history",
  "arguments": {
    "addresses": [
      { "token_address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "chain": "ethereum" }
    ],
    "start_timestamp": "2026-01-01T00:00:00Z",
    "end_timestamp": "2026-01-31T23:59:59Z",
    "time_granularity": "1h"
  }
}

Paginate with the cursor parameter.

Wallet balances

{
  "name": "realtime_latest_token_balances",
  "arguments": {
    "addresses": [
      { "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "chain": "ethereum" },
      { "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "chain": "base" }
    ]
  }
}

Multi-chain is just multiple entries in one call — there’s no separate multi-chain tool.

Transactions

{
  "name": "realtime_transactions",
  "arguments": {
    "addresses": [
      { "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "chain": "ethereum" }
    ],
    "limit": 100
  }
}

Returns enriched activity — decoded activities, asset transfers, and address labels — not raw transaction rows.

DeFi positions

{
  "name": "realtime_get_positions",
  "arguments": {
    "payload": [
      { "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "chain": "ethereum" }
    ],
    "limit": 100
  }
}

Holdings and PnL

realtime_holdings_history gives aggregated USD holdings over time. The four PnL tools split along two axes: current versus historical, and whole-wallet versus per-token.

{
  "name": "realtime_holdings_pnl",
  "arguments": {
    "addresses": [
      { "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "chain": "ethereum" }
    ],
    "min_liquidity": 10000
  }
}

The _history variants take start_timestamp, end_timestamp, and granularity alongside addresses. Of the holdings tools, only realtime_holdings_history paginates — the PnL history tools return their full range in one response.

SQL or realtime?

Use realtime tools

Current state, a specific wallet or token, recent history. Single-digit-second responses, no query queue.

Use SQL

Aggregations across many addresses, full history, joins across verticals, anything you want to chart. See SQL & queries.

All realtime tools except realtime_get_supported_chains consume Developer Units, at 20–60 DU per call, multiplied by the number of batched inputs. See Billing & limits.

Realtime APIs

The REST endpoints behind these tools

Prices API

Full prices reference

Wallets API

Full wallets reference

Hyperliquid tools

Perps info, fills, orders, orderbooks

Assistant

MCP

Machine Payments

Available tools

Discovery

Prices

Wallets

Holdings & PnL

Tokens & assets

Every tool names its own docs

Batching

Tool usage

Latest prices

Price history

Wallet balances

Transactions

DeFi positions

Holdings and PnL

SQL or realtime?

Use realtime tools

Use SQL

Realtime APIs

Prices API

Wallets API

Hyperliquid tools

​Available tools

​Discovery

​Prices

​Wallets

​Holdings & PnL

​Tokens & assets

​Every tool names its own docs

​Batching

​Tool usage

​Latest prices

​Price history

​Wallet balances

​Transactions

​DeFi positions

​Holdings and PnL

​SQL or realtime?

Use realtime tools

Use SQL

​Related resources

Realtime APIs

Prices API

Wallets API

Hyperliquid tools

Available tools

Discovery

Prices

Wallets

Holdings & PnL

Tokens & assets

Every tool names its own docs

Batching

Tool usage

Latest prices

Price history

Wallet balances

Transactions

DeFi positions

Holdings and PnL

SQL or realtime?

Related resources