# Token Metrics

Token Metrics provides an API offering real-time, AI-powered cryptocurrency data and insights for developers to build trading bots, dashboards, and portfolio tools.

- **Category:** analytics
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `TOKEN_METRICS`
- **Version:** 20260316_00

## Tools

### Get Price

**Slug:** `TOKEN_METRICS_GET_PRICE`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of tokens to return. |
| `currency` | string | No | Fiat currency code for quoted price (default 'USD'). |
| `token_id` | string | Yes | Numeric token ID as returned by /tokens endpoint. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Technical Indicators

**Slug:** `TOKEN_METRICS_GET_TECHNICAL_INDICATORS`

Tool to retrieve technical indicators for a token. Use when you need technical analysis data for a specific symbol, interval, and indicator.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of data points to retrieve (default is 100, max 1000). |
| `symbol` | string | Yes | The ticker symbol to query (e.g., 'BTCUSDT'). |
| `end_time` | string | No | ISO-8601 end time for the data range (e.g., '2023-06-08T00:00:00Z'). |
| `exchange` | string | No | Exchange code for the symbol (e.g., 'BINANCE'). |
| `interval` | string | Yes | Timeframe interval for the data (e.g., '1h', '4h', '1d'). |
| `indicator` | string | Yes | Name of the technical indicator to retrieve (e.g., 'rsi', 'macd'). |
| `start_time` | string | No | ISO-8601 start time for the data range (e.g., '2023-06-01T00:00:00Z'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tokens

**Slug:** `TOKEN_METRICS_GET_TOKENS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based index) |
| `limit` | integer | No | Number of results per page |
| `search` | string | No | Search tokens by name or symbol (case-insensitive) |
| `sort_by` | string ("market_cap" | "price" | "volume_24h") | No | Field to sort by |
| `category` | string | No | Filter tokens by category |
| `price_max` | number | No | Maximum token price filter |
| `price_min` | number | No | Minimum token price filter |
| `blockchain` | string | No | Filter tokens by blockchain network |
| `sort_order` | string ("asc" | "desc") | No | Sort order: ascending or descending |
| `market_cap_max` | number | No | Maximum market capitalization filter |
| `market_cap_min` | number | No | Minimum market capitalization filter |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Top Market Cap Tokens

**Slug:** `TOKEN_METRICS_GET_TOP_MARKET_CAP_TOKENS`

Tool to retrieve a list of tokens ranked by market capitalization. Use when you need an overview of the most valuable cryptocurrencies.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, must be at least 1. |
| `limit` | integer | No | Number of tokens to return, must be at least 1. |
| `sector` | string | No | Sector filter (e.g., 'DeFi', 'NFT'). |
| `currency` | string | No | Quote currency for market cap (e.g., 'USD', 'EUR'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Trading Signals

**Slug:** `TOKEN_METRICS_GET_TRADING_SIGNALS`

Tool to retrieve entry and exit crypto trading signals. Use when optimizing trading strategies with signal-based insights.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of signals to return, must be at least 1. |
| `offset` | integer | No | Number of signals to skip for pagination, must be non-negative. |
| `symbol` | string | No | Cryptocurrency symbol to filter by (e.g., 'BTC', 'ETH'). |
| `exchange` | string | No | Exchange name to filter (e.g., 'Binance'). |
| `timeframe` | string | No | Timeframe for analysis (e.g., '1h', '1d'). |
| `signal_type` | string | No | Type of signal to filter (buy, sell, neutral). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |