Token Metrics provides an API offering real-time, AI-powered cryptocurrency data and insights for developers to build trading bots, dashboards, and portfolio tools.
Token Metrics provides an API offering real-time, AI-powered cryptocurrency data and insights for developers to build trading bots, dashboards, and portfolio tools. On Nagent, Token Metrics is exposed as a fully-configurable analytics integration that any agent can call — 5 actions, and API key authentication. No code is required to wire Token Metrics into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Token Metrics to automate the kinds of tasks analytics teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Token Metrics into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Token Metrics, with input parameters and output schema. Drop these into any step of an agent built in Helix.
TOKEN_METRICS_GET_PRICETool to retrieve real-time price and market metrics for a given cryptocurrency. Use when you need the latest price, volume, and market cap information for trading or analysis. Response fields like `volume24h` or `numberOfHolders` may be absent; treat missing fields as null, not zero.
Input parameters
Maximum number of tokens to return.
Fiat currency code for quoted price (default 'USD').
Numeric token ID as returned by /tokens endpoint.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TOKEN_METRICS_GET_TECHNICAL_INDICATORSTool to retrieve technical indicators for a token. Use when you need technical analysis data for a specific symbol, interval, and indicator.
Input parameters
Number of data points to retrieve (default is 100, max 1000).
The ticker symbol to query (e.g., 'BTCUSDT').
ISO-8601 end time for the data range (e.g., '2023-06-08T00:00:00Z').
Exchange code for the symbol (e.g., 'BINANCE').
Timeframe interval for the data (e.g., '1h', '4h', '1d').
Name of the technical indicator to retrieve (e.g., 'rsi', 'macd').
ISO-8601 start time for the data range (e.g., '2023-06-01T00:00:00Z').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TOKEN_METRICS_GET_TOKENSTool to retrieve a paginated list of supported tokens with metadata. Use when you need comprehensive token listings across price, market cap, supply, and contract details. Returns token_id values required by TOKEN_METRICS_GET_PRICE and other endpoints — build your token_id mapping here first. Response fields such as volume24h and numberOfHolders may be absent for some tokens; treat missing values as null/unknown, not zero. tokenCreationDate is ISO-8601; convert to UTC for accurate age comparisons.
Input parameters
Page number for pagination (1-based index)
Number of results per page
Search tokens by name or symbol (case-insensitive)
Field to sort by
Filter tokens by category
Maximum token price filter
Minimum token price filter
Filter tokens by blockchain network
Sort order: ascending or descending
Maximum market capitalization filter
Minimum market capitalization filter
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TOKEN_METRICS_GET_TOP_MARKET_CAP_TOKENSTool to retrieve a list of tokens ranked by market capitalization. Use when you need an overview of the most valuable cryptocurrencies.
Input parameters
Page number for pagination, must be at least 1.
Number of tokens to return, must be at least 1.
Sector filter (e.g., 'DeFi', 'NFT').
Quote currency for market cap (e.g., 'USD', 'EUR').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TOKEN_METRICS_GET_TRADING_SIGNALSTool to retrieve entry and exit crypto trading signals. Use when optimizing trading strategies with signal-based insights.
Input parameters
Maximum number of signals to return, must be at least 1.
Number of signals to skip for pagination, must be non-negative.
Cryptocurrency symbol to filter by (e.g., 'BTC', 'ETH').
Exchange name to filter (e.g., 'Binance').
Timeframe for analysis (e.g., '1h', '1d').
Type of signal to filter (buy, sell, neutral).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 37 agents privately built on Nagent that already use Token Metrics.
Build on Nagent
Connect Token Metrics to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Token Metrics, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Token Metrics is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Token Metrics is connected, you configure its 5 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Token Metrics steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Token Metrics event fires, the agent kicks off automatically.
Every Token Metrics action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Token Metrics ships with 5 pre-built analytics actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Token Metrics together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Token Metrics-based workflows tailored to your business.