Realtime API Tools

Overview

Realtime API tools provide access to current and historical blockchain data without writing SQL queries. These tools are optimized for common use cases like price lookups, wallet balances, and transaction history.

Available Tools

Tool Name	Description
`realtime_get_token_price`	Get the latest price for a token on a specific chain
`realtime_get_multiple_token_prices`	Get latest prices for multiple tokens across chains
`realtime_get_token_price_history`	Get historical price data for a token with time-series data (OHLCV)
`realtime_get_token_price_stats`	Get price statistics including 24h/1h high/low and percent changes
`realtime_get_token_price_at_timestamp`	Get token price at a specific historical timestamp
`realtime_get_wallet_balances`	Get current token balances for a wallet address on a specific chain
`realtime_get_multi_chain_balances`	Get token balances across multiple chains for the same address
`realtime_get_wallet_transactions`	Get transaction history for wallet addresses
`realtime_get_wallet_historical_balances`	Get historical token balances over a time range

Tool Usage

Token Prices

Get Current Price

Get the latest price for a single token:

{
  "name": "realtime_get_token_price",
  "arguments": {
    "token_address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
    "chain": "ethereum",
    "with_liquidity_info": true
  }
}

Get Multiple Prices

Get latest prices for multiple tokens at once:

{
  "name": "realtime_get_multiple_token_prices",
  "arguments": {
    "tokens": [
      {"token_address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "chain": "ethereum"},
      {"token_address": "So11111111111111111111111111111111111111112", "chain": "solana"}
    ],
    "with_liquidity_info": false
  }
}

Get Price History

Get historical price data with time-series (OHLCV):

{
  "name": "realtime_get_token_price_history",
  "arguments": {
    "token_address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
    "chain": "ethereum",
    "start_timestamp": "2025-01-01T00:00:00Z",
    "end_timestamp": "2025-01-31T23:59:59Z",
    "granularity": "1h"
  }
}

Granularity options: 15s, 1m, 5m, 1h, 1d

Get Price Statistics

Get price statistics including 24h/1h highs/lows and percent changes:

{
  "name": "realtime_get_token_price_stats",
  "arguments": {
    "tokens": [
      {"token_address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "chain": "ethereum"}
    ]
  }
}

Get Price at Timestamp

Get token price at a specific historical timestamp:

{
  "name": "realtime_get_token_price_at_timestamp",
  "arguments": {
    "tokens": [
      {"token_address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "chain": "ethereum"}
    ],
    "timestamp": "2025-01-15T12:00:00Z",
    "time_granularity": "1m"
  }
}

Wallet Data

Get Current Balances

Get current token balances for a wallet address:

{
  "name": "realtime_get_wallet_balances",
  "arguments": {
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "chain": "ethereum",
    "with_liquidity_info": true
  }
}

Get Multi-Chain Balances

Get balances across multiple chains for the same address:

{
  "name": "realtime_get_multi_chain_balances",
  "arguments": {
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "chains": ["ethereum", "polygon", "base"],
    "with_liquidity_info": false
  }
}

Get Transaction History

Get transaction history for wallet addresses:

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

Note: Maximum 20 addresses per request.

Get Historical Balances

Get historical token balances over a time range:

{
  "name": "realtime_get_wallet_historical_balances",
  "arguments": {
    "addresses": [
      {"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "chain": "ethereum"}
    ],
    "start_timestamp": "2025-01-01T00:00:00Z",
    "end_timestamp": "2025-01-31T23:59:59Z",
    "limit": 1000
  }
}

Realtime APIs

REST API documentation for Realtime APIs

Prices API

Detailed prices API reference

Wallets API

Detailed wallets API reference

Assistant

MCP

Machine Payments

Overview

Available Tools

Tool Usage

Token Prices

Get Current Price

Get Multiple Prices

Get Price History

Get Price Statistics

Get Price at Timestamp

Wallet Data

Get Current Balances

Get Multi-Chain Balances

Get Transaction History

Get Historical Balances

Realtime APIs

Prices API

Wallets API

​Overview

​Available Tools

​Tool Usage

​Token Prices

​Get Current Price

​Get Multiple Prices

​Get Price History

​Get Price Statistics

​Get Price at Timestamp

​Wallet Data

​Get Current Balances

​Get Multi-Chain Balances

​Get Transaction History

​Get Historical Balances

​Related Resources

Realtime APIs

Prices API

Wallets API

Overview

Available Tools

Tool Usage

Token Prices

Get Current Price

Get Multiple Prices

Get Price History

Get Price Statistics

Get Price at Timestamp

Wallet Data

Get Current Balances

Get Multi-Chain Balances

Get Transaction History

Get Historical Balances

Related Resources