Skip to main content
Glama

Loading token info

token_info
Read-onlyIdempotent

Get token information — spot on-chain details or Hyperliquid perpetual futures stats.

On-chain tokens mode (default): Returns token details (name, symbol, market cap, FDV, supply, deployment date, socials) and spot trading metrics (volume, buys/sells, buyers/sellers, holders, liquidity).

Perps mode: Returns Hyperliquid perp stats — mark price, funding, open interest, buy/sell pressure, trader participation.

Returns: Token information as markdown.

On-chain tokens fields:
- **Market Cap / FDV**: Market capitalization and fully diluted valuation
- **Circulating / Total Supply**: Token supply metrics
- **Deployed**: When the token was deployed
- **DEX Volume (Total / Buy / Sell)**: On-chain DEX trading volume in USD. It does not include CEX volume.
- **Buys / Sells**: Number of buy/sell transactions
- **Unique Buyers / Sellers**: Distinct trading addresses
- **Total Holders**: Number of token holders
- **Liquidity**: Available liquidity in USD

Perps fields:
- **Mark Price**: Current perp mark price
- **Price Change**: Change vs previous price
- **Max Leverage**: Maximum leverage offered for the perp on Hyperliquid (e.g. "40x")
- **Funding Rate (hourly/annualized)**: Current funding rate
- **Open Interest**: Total current open interest in USD
- **Volume (Total / Buy / Sell)**: Perp volume in USD
- **Net Flow (Buy - Sell)**: Buy/sell pressure in USD
- **Traders**: Number of traders

Example: On-chain tokens (default mode): { "mode": "onchain_tokens", "chain": "ethereum", "tokenAddress": "0xa0b86a33e6b6c4b3add000b44b3a1234567890ab", "timeframe": "1d" }

Hyperliquid perps:
```
{
  "mode": "perps",
  "tokenAddress": "BTC",
  "timeframe": "7d"
}
```

Notes: - On-chain tokens mode uses contract addresses - Perps mode uses token symbols (e.g. BTC, ETH, HYPE) - Both modes use the same timeframe parameter

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "request": "<request>"
    },
    "name": "token_info"
  }
}

Input Schema

NameRequiredDescriptionDefault
requestYesRequest for token info — spot (on-chain token details) or perps (Hyperliquid stats).

Output Schema

NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / request / properties / tokenAddress / description
      Added value: +"Token contract address or Solana mint address. Use general_search to resolve a token name to its address and chain. For a tool with a perps mode, use the Hyperliquid coin symbol in that mode."
  2. Changed6 schema fields changed
    • addedInput schema / properties / request / additionalProperties
      Added value: +false
    • removedInput schema / properties / request / anyOf
      Removed value: -[
      -  {
      -    "additionalProperties": true,
      -    "type": "object"
      -  },
      -  {
      -    "description": "Request for token info — spot (on-chain token details) or perps (Hyperliquid stats).",
      -    "properties": {
      -      "chain": {
      -        "default": "ethereum",
      -        "description": "Blockchain network. Supported: arbitrum, arc, avalanche, base, bnb, ethereum, hyperevm, injective, iotaevm, linea, mantle, mantra, monad, near, optimism, plasma, polygon, robinhood, ronin, scroll, sei, solana, sonic, sui, ton, tron, unichain, zksync",
      -        "type": "string"
      -      },
      -      "mode": {
      -        "default": "onchain_tokens",
      -        "description": "Analysis mode: 'onchain_tokens' for on-chain token information, 'perps' for Hyperliquid perpetual futures stats by symbol. If mode is omitted and token_address is a symbol (not a contract address), mode defaults to 'perps'.",
      -        "enum": [
      -          "onchain_tokens",
      -          "perps"
      -        ],
      -        "type": "string"
      -      },
      -      "timeframe": {
      -        "default": "1d",
      -        "description": "Timeframe for token metrics (5m, 1h, 6h, 12h, 1d, 7d)",
      -        "enum": [
      -          "5m",
      -          "1h",
      -          "6h",
      -          "12h",
      -          "1d",
      -          "7d"
      -        ],
      -        "type": "string"
      -      },
      -      "tokenAddress": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "tokenAddress"
      -    ],
      -    "type": "object"
      -  }
      -]
    • addedInput schema / properties / request / description
      Added value: +"Request for token info — spot (on-chain token details) or perps (Hyperliquid stats)."
    • addedInput schema / properties / request / properties
      Added value: +{
      +  "chain": {
      +    "default": "ethereum",
      +    "description": "Blockchain network. Supported: arbitrum, arc, avalanche, base, bnb, ethereum, hyperevm, injective, iotaevm, linea, mantle, mantra, monad, near, optimism, plasma, polygon, robinhood, ronin, scroll, sei, solana, sonic, sui, ton, tron, unichain, zksync",
      +    "type": "string"
      +  },
      +  "mode": {
      +    "default": "onchain_tokens",
      +    "description": "Analysis mode: 'onchain_tokens' for on-chain token information, 'perps' for Hyperliquid perpetual futures stats by symbol. If mode is omitted and token_address is a symbol (not a contract address), mode defaults to 'perps'.",
      +    "enum": [
      +      "onchain_tokens",
      +      "perps"
      +    ],
      +    "type": "string"
      +  },
      +  "timeframe": {
      +    "default": "1d",
      +    "description": "Timeframe for token metrics (5m, 1h, 6h, 12h, 1d, 7d)",
      +    "enum": [
      +      "5m",
      +      "1h",
      +      "6h",
      +      "12h",
      +      "1d",
      +      "7d"
      +    ],
      +    "type": "string"
      +  },
      +  "tokenAddress": {
      +    "type": "string"
      +  }
      +}
    • addedInput schema / properties / request / required
      Added value: +[
      +  "tokenAddress"
      +]
    • addedInput schema / properties / request / type
      Added value: +"object"
  3. Changed1 schema field changed
    • changedInput schema / properties / request / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "type": "object"
      -  },
      -  {
      -    "description": "Request for token info — spot (on-chain token details) or perps (Hyperliquid stats).",
      -    "properties": {
      -      "chain": {
      -        "default": "ethereum",
      -        "description": "Blockchain network. Supported: arbitrum, avalanche, base, bnb, ethereum, hyperevm, injective, iotaevm, linea, mantle, mantra, monad, near, optimism, plasma, polygon, robinhood, ronin, scroll, sei, solana, sonic, sui, ton, tron, unichain, zksync",
      -        "type": "string"
      -      },
      -      "mode": {
      -        "default": "onchain_tokens",
      -        "description": "Analysis mode: 'onchain_tokens' for on-chain token information, 'perps' for Hyperliquid perpetual futures stats by symbol. If mode is omitted and token_address is a symbol (not a contract address), mode defaults to 'perps'.",
      -        "enum": [
      -          "onchain_tokens",
      -          "perps"
      -        ],
      -        "type": "string"
      -      },
      -      "timeframe": {
      -        "default": "1d",
      -        "description": "Timeframe for token metrics (5m, 1h, 6h, 12h, 1d, 7d)",
      -        "enum": [
      -          "5m",
      -          "1h",
      -          "6h",
      -          "12h",
      -          "1d",
      -          "7d"
      -        ],
      -        "type": "string"
      -      },
      -      "tokenAddress": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "tokenAddress"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": true,
      +    "type": "object"
      +  },
      +  {
      +    "description": "Request for token info — spot (on-chain token details) or perps (Hyperliquid stats).",
      +    "properties": {
      +      "chain": {
      +        "default": "ethereum",
      +        "description": "Blockchain network. Supported: arbitrum, arc, avalanche, base, bnb, ethereum, hyperevm, injective, iotaevm, linea, mantle, mantra, monad, near, optimism, plasma, polygon, robinhood, ronin, scroll, sei, solana, sonic, sui, ton, tron, unichain, zksync",
      +        "type": "string"
      +      },
      +      "mode": {
      +        "default": "onchain_tokens",
      +        "description": "Analysis mode: 'onchain_tokens' for on-chain token information, 'perps' for Hyperliquid perpetual futures stats by symbol. If mode is omitted and token_address is a symbol (not a contract address), mode defaults to 'perps'.",
      +        "enum": [
      +          "onchain_tokens",
      +          "perps"
      +        ],
      +        "type": "string"
      +      },
      +      "timeframe": {
      +        "default": "1d",
      +        "description": "Timeframe for token metrics (5m, 1h, 6h, 12h, 1d, 7d)",
      +        "enum": [
      +          "5m",
      +          "1h",
      +          "6h",
      +          "12h",
      +          "1d",
      +          "7d"
      +        ],
      +        "type": "string"
      +      },
      +      "tokenAddress": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "tokenAddress"
      +    ],
      +    "type": "object"
      +  }
      +]
  4. Changed1 schema field changed
    • changedInput schema / properties / request / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "type": "object"
      -  },
      -  {
      -    "description": "Request for token info — spot (on-chain token details) or perps (Hyperliquid stats).",
      -    "properties": {
      -      "chain": {
      -        "default": "ethereum",
      -        "description": "Blockchain network. Supported: arbitrum, avalanche, base, bnb, ethereum, hyperevm, injective, iotaevm, linea, mantle, mantra, monad, near, optimism, plasma, polygon, ronin, scroll, sei, solana, sonic, sui, ton, tron, unichain, zksync",
      -        "type": "string"
      -      },
      -      "mode": {
      -        "default": "onchain_tokens",
      -        "description": "Analysis mode: 'onchain_tokens' for on-chain token information, 'perps' for Hyperliquid perpetual futures stats by symbol. If mode is omitted and token_address is a symbol (not a contract address), mode defaults to 'perps'.",
      -        "enum": [
      -          "onchain_tokens",
      -          "perps"
      -        ],
      -        "type": "string"
      -      },
      -      "timeframe": {
      -        "default": "1d",
      -        "description": "Timeframe for token metrics (5m, 1h, 6h, 12h, 1d, 7d)",
      -        "enum": [
      -          "5m",
      -          "1h",
      -          "6h",
      -          "12h",
      -          "1d",
      -          "7d"
      -        ],
      -        "type": "string"
      -      },
      -      "tokenAddress": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "tokenAddress"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": true,
      +    "type": "object"
      +  },
      +  {
      +    "description": "Request for token info — spot (on-chain token details) or perps (Hyperliquid stats).",
      +    "properties": {
      +      "chain": {
      +        "default": "ethereum",
      +        "description": "Blockchain network. Supported: arbitrum, avalanche, base, bnb, ethereum, hyperevm, injective, iotaevm, linea, mantle, mantra, monad, near, optimism, plasma, polygon, robinhood, ronin, scroll, sei, solana, sonic, sui, ton, tron, unichain, zksync",
      +        "type": "string"
      +      },
      +      "mode": {
      +        "default": "onchain_tokens",
      +        "description": "Analysis mode: 'onchain_tokens' for on-chain token information, 'perps' for Hyperliquid perpetual futures stats by symbol. If mode is omitted and token_address is a symbol (not a contract address), mode defaults to 'perps'.",
      +        "enum": [
      +          "onchain_tokens",
      +          "perps"
      +        ],
      +        "type": "string"
      +      },
      +      "timeframe": {
      +        "default": "1d",
      +        "description": "Timeframe for token metrics (5m, 1h, 6h, 12h, 1d, 7d)",
      +        "enum": [
      +          "5m",
      +          "1h",
      +          "6h",
      +          "12h",
      +          "1d",
      +          "7d"
      +        ],
      +        "type": "string"
      +      },
      +      "tokenAddress": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "tokenAddress"
      +    ],
      +    "type": "object"
      +  }
      +]
  5. Changed1 schema field changed
    • changedInput schema / properties / request / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "type": "object"
      -  },
      -  {
      -    "description": "Request for token info — spot (on-chain token details) or perps (Hyperliquid stats).",
      -    "properties": {
      -      "chain": {
      -        "default": "ethereum",
      -        "description": "Blockchain network. Supported: arbitrum, avalanche, base, bnb, ethereum, hyperevm, injective, iotaevm, linea, mantle, mantra, monad, near, optimism, plasma, polygon, ronin, scroll, sei, solana, sonic, sui, ton, tron, unichain, zksync",
      -        "type": "string"
      -      },
      -      "mode": {
      -        "default": "onchain_tokens",
      -        "description": "Analysis mode: 'onchain_tokens' for on-chain token information, 'perps' for Hyperliquid perpetual futures stats by symbol",
      -        "enum": [
      -          "onchain_tokens",
      -          "perps"
      -        ],
      -        "type": "string"
      -      },
      -      "timeframe": {
      -        "default": "1d",
      -        "description": "Timeframe for token metrics (5m, 1h, 6h, 12h, 1d, 7d)",
      -        "enum": [
      -          "5m",
      -          "1h",
      -          "6h",
      -          "12h",
      -          "1d",
      -          "7d"
      -        ],
      -        "type": "string"
      -      },
      -      "tokenAddress": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "tokenAddress"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": true,
      +    "type": "object"
      +  },
      +  {
      +    "description": "Request for token info — spot (on-chain token details) or perps (Hyperliquid stats).",
      +    "properties": {
      +      "chain": {
      +        "default": "ethereum",
      +        "description": "Blockchain network. Supported: arbitrum, avalanche, base, bnb, ethereum, hyperevm, injective, iotaevm, linea, mantle, mantra, monad, near, optimism, plasma, polygon, ronin, scroll, sei, solana, sonic, sui, ton, tron, unichain, zksync",
      +        "type": "string"
      +      },
      +      "mode": {
      +        "default": "onchain_tokens",
      +        "description": "Analysis mode: 'onchain_tokens' for on-chain token information, 'perps' for Hyperliquid perpetual futures stats by symbol. If mode is omitted and token_address is a symbol (not a contract address), mode defaults to 'perps'.",
      +        "enum": [
      +          "onchain_tokens",
      +          "perps"
      +        ],
      +        "type": "string"
      +      },
      +      "timeframe": {
      +        "default": "1d",
      +        "description": "Timeframe for token metrics (5m, 1h, 6h, 12h, 1d, 7d)",
      +        "enum": [
      +          "5m",
      +          "1h",
      +          "6h",
      +          "12h",
      +          "1d",
      +          "7d"
      +        ],
      +        "type": "string"
      +      },
      +      "tokenAddress": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "tokenAddress"
      +    ],
      +    "type": "object"
      +  }
      +]
  6. Changed3 schema fields changed
    • removedInput schema / $defs
      Removed value: -{
      -  "LookbackPeriod": {
      -    "description": "Lookback periods for time-based analysis.",
      -    "enum": [
      -      "5m",
      -      "1h",
      -      "6h",
      -      "12h",
      -      "1d",
      -      "7d"
      -    ],
      -    "type": "string"
      -  },
      -  "TokenInfoRequest": {
      -    "description": "Request for token info — spot (on-chain token details) or perps (Hyperliquid stats).",
      -    "properties": {
      -      "chain": {
      -        "default": "ethereum",
      -        "description": "Blockchain network. Supported: arbitrum, avalanche, base, bnb, ethereum, hyperevm, injective, iotaevm, linea, mantle, mantra, monad, near, optimism, plasma, polygon, ronin, scroll, sei, solana, sonic, sui, ton, tron, unichain, zksync",
      -        "type": "string"
      -      },
      -      "mode": {
      -        "default": "onchain_tokens",
      -        "description": "Analysis mode: 'onchain_tokens' for on-chain token information, 'perps' for Hyperliquid perpetual futures stats by symbol",
      -        "enum": [
      -          "onchain_tokens",
      -          "perps"
      -        ],
      -        "type": "string"
      -      },
      -      "timeframe": {
      -        "$ref": "#/$defs/LookbackPeriod",
      -        "default": "1d",
      -        "description": "Timeframe for token metrics (5m, 1h, 6h, 12h, 1d, 7d)"
      -      },
      -      "tokenAddress": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "tokenAddress"
      -    ],
      -    "type": "object"
      -  }
      -}
    • addedInput schema / additionalProperties
      Added value: +false
    • changedInput schema / properties / request / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "type": "object"
      -  },
      -  {
      -    "$ref": "#/$defs/TokenInfoRequest"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": true,
      +    "type": "object"
      +  },
      +  {
      +    "description": "Request for token info — spot (on-chain token details) or perps (Hyperliquid stats).",
      +    "properties": {
      +      "chain": {
      +        "default": "ethereum",
      +        "description": "Blockchain network. Supported: arbitrum, avalanche, base, bnb, ethereum, hyperevm, injective, iotaevm, linea, mantle, mantra, monad, near, optimism, plasma, polygon, ronin, scroll, sei, solana, sonic, sui, ton, tron, unichain, zksync",
      +        "type": "string"
      +      },
      +      "mode": {
      +        "default": "onchain_tokens",
      +        "description": "Analysis mode: 'onchain_tokens' for on-chain token information, 'perps' for Hyperliquid perpetual futures stats by symbol",
      +        "enum": [
      +          "onchain_tokens",
      +          "perps"
      +        ],
      +        "type": "string"
      +      },
      +      "timeframe": {
      +        "default": "1d",
      +        "description": "Timeframe for token metrics (5m, 1h, 6h, 12h, 1d, 7d)",
      +        "enum": [
      +          "5m",
      +          "1h",
      +          "6h",
      +          "12h",
      +          "1d",
      +          "7d"
      +        ],
      +        "type": "string"
      +      },
      +      "tokenAddress": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "tokenAddress"
      +    ],
      +    "type": "object"
      +  }
      +]
  7. Changed1 schema field changed
    • changedInput schema / $defs / TokenInfoRequest / properties / chain / description
      Previous value: -"Blockchain network. Supported: arbitrum, avalanche, base, bnb, ethereum, hyperevm, injective, iotaevm, linea, mantle, monad, near, optimism, plasma, polygon, ronin, scroll, sei, solana, sonic, sui, ton, tron, unichain, zksync"New value: +"Blockchain network. Supported: arbitrum, avalanche, base, bnb, ethereum, hyperevm, injective, iotaevm, linea, mantle, mantra, monad, near, optimism, plasma, polygon, ronin, scroll, sei, solana, sonic, sui, ton, tron, unichain, zksync"
  8. Added

TDQS

A3.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare this as a read-only, idempotent, open-world, non-destructive call, so the safety bar is low; the description still adds value by stating the output format ('Token information as markdown') and defining the meaning of key metrics, e.g. that DEX volume explicitly excludes CEX volume. The mode-specific field lists document what each call actually surfaces. It is consistent with the annotations throughout.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The core guidance is front-loaded well: mode split first, then return summary, then examples, then notes. However, the two long field-by-field enumerations are bulky and largely duplicate what the output schema already carries, consuming roughly half the description's length without adding decision-relevant information for an agent selecting or invoking the tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with one nested request object and an existing output schema, the description covers modes, address-vs-symbol semantics, the shared timeframe parameter, and concrete examples, which is enough to call it correctly. The only inefficiency is that it explains return fields at length even though an output schema exists, so the coverage is complete but somewhat misallocated.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and the schema already documents mode, chain (with the full supported list), timeframe enum, and tokenAddress resolution. The description goes beyond that by supplying two complete worked request examples and reiterating the address-vs-symbol rule per mode, which makes correct invocation materially easier. It adds illustrative value rather than only restating the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening line names a specific verb and resource ('Get token information') and immediately splits it into two well-defined modes: on-chain spot details vs Hyperliquid perpetual futures stats. An agent can tell which mode it needs from the field descriptions alone. It does not, however, explicitly distinguish itself from the many sibling token_* tools (token_ohlcv, token_flows, token_technical_indicators), so it falls short of a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

'On-chain tokens mode (default)' and 'Perps mode' give clear context for choosing between the tool's two internal modes, and the notes clarify that on-chain mode takes contract addresses while perps mode takes symbols like BTC/ETH. There is no guidance on when to reach for a different sibling tool instead of this one, and no stated prerequisites or exclusions, so usage guidance is implied rather than explicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources