Token & Contract Tools

15 tools for token information, holder analysis, and on-chain token analytics.

MCP Endpoint: POST /hive_token_contract/mcp

Data Sources: Codex, GeckoTerminal

Token Information

get_token_info

Get detailed information about a specific token.

Parameter	Type	Required	Description
networkId	number	Yes	Network ID
address	string	Yes	Token contract address

Example:

curl -X POST https://api.hiveintelligence.xyz/api/execute \
  -H "Content-Type: application/json" \
  -d '{
    "toolName": "get_token_info",
    "arguments": {
      "networkId": 1,
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
    }
  }'

get_token_details

Get detailed token data including metadata and market information.

Parameter	Type	Required	Description
network	string	Yes	Network ID
address	string	Yes	Token contract address
include	string	No	Include: `top_pools`

get_tokens

Get information about multiple tokens.

Parameter	Type	Required	Description
ids	array	Yes	Array of token IDs (`address:networkId` format)

get_tokens_by_address

Query token data based on contract address.

Parameter	Type	Required	Description
network	string	Yes	Network ID
address	string	Yes	Token contract address
include	string	No	Include: `top_pools`

get_multi_tokens

Query multiple tokens (up to 50 per request).

Parameter	Type	Required	Description
network	string	Yes	Network ID
addresses	string	Yes	Comma-separated token addresses (max 50)
include	string	No	Include: `top_pools`

get_coin_metadata

Get comprehensive coin metadata from CoinGecko.

Parameter	Type	Required	Description
id	string	Yes	CoinGecko coin ID
market_data	boolean	No	Include market data (default: true)
community_data	boolean	No	Include community stats
developer_data	boolean	No	Include developer stats
sparkline	boolean	No	Include 7-day sparkline
tickers	boolean	No	Include exchange tickers
localization	boolean	No	Include localized names

Token Discovery

get_new_tokens

Get the latest token contracts deployed.

Parameter	Type	Required	Description
networkFilter	array	No	Network IDs to filter
limit	number	No	Maximum results
offset	number	No	Pagination offset

Available on Ethereum (1), Optimism (10), Base (8453), Arbitrum (42161)

get_recently_updated_tokens

Get tokens with recently updated metadata.

Parameter	Type	Required	Description
page	number	No	Page number (default: 1)
include	string	No	Include: `network`

filter_tokens

Search and filter tokens by various criteria.

Parameter	Type	Required	Description
phrase	string	No	Search phrase (address, name, symbol)
tokens	array	No	Token IDs to filter
excludeTokens	array	No	Token IDs to exclude
filters	object	No	Filter criteria (see below)
rankings	array	No	Ranking attributes
statsType	string	No	`FILTERED` or `UNFILTERED`
limit	number	No	Maximum results
offset	number	No	Pagination offset

Filter options:

buyCount1, buyCount4, buyCount24 - Buy transactions by period
sellCount1, sellCount4, sellCount24 - Sell transactions by period
change1, change4, change24 - Price changes by period
Numeric filters use gt, gte, lt, lte operators

Example:

curl -X POST https://api.hiveintelligence.xyz/api/execute \
  -H "Content-Type: application/json" \
  -d '{
    "toolName": "filter_tokens",
    "arguments": {
      "phrase": "pepe",
      "limit": 10
    }
  }'

Holder Analysis

get_token_holders

Get holders of a token ordered by holdings.

Parameter	Type	Required	Description
networkId	number	Yes	Network ID
address	string	Yes	Token contract address
cursor	string	No	Pagination cursor
sort	object	No	Sort with `attribute` and `direction`

get_token_top_holders

Get top token holders by balance.

Parameter	Type	Required	Description
network	string	Yes	Network ID
address	string	Yes	Token contract address
holders	string	No	Number of holders (integer or "max", default: 10)

get_token_holders_chart

Get historical token holders chart.

Parameter	Type	Required	Description
network	string	Yes	Network ID
token_address	string	Yes	Token contract address
days	string	No	Days: `7`, `30`, or `max` (default: 7)

get_top_holders_percentage

Get percentage of tokens held by top 10 holders.

Parameter	Type	Required	Description
networkId	number	Yes	Network ID
address	string	Yes	Token contract address

Token Events & Trading

get_token_lifecycle_events

Get mint and burn events for a token.

Parameter	Type	Required	Description
query.address	string	Yes	Token contract address
query.networkId	number	Yes	Network ID
limit	number	No	Maximum events
cursor	string	No	Pagination cursor

Response includes:

Mint events with amounts
Burn events with amounts
Timestamps
Supply changes

get_token_top_traders

Get top traders for a token over a time period.

Parameter	Type	Required	Description
input.tokenAddress	string	Yes	Token contract address
input.networkId	number	Yes	Network ID
input.tradingPeriod	string	Yes	`DAY`, `WEEK`, `MONTH`, or `YEAR`
input.limit	number	No	Number of traders
input.offset	number	No	Pagination offset

Example:

curl -X POST https://api.hiveintelligence.xyz/api/execute \
  -H "Content-Type: application/json" \
  -d '{
    "toolName": "get_token_top_traders",
    "arguments": {
      "input": {
        "tokenAddress": "0x...",
        "networkId": 1,
        "tradingPeriod": "WEEK",
        "limit": 10
      }
    }
  }'

Response includes:

Trading volumes
Realized profits
Transaction counts
Win rates

Supported Networks

Network	ID	Name
Ethereum	1	eth
BNB Chain	56	bsc
Polygon	137	polygon
Arbitrum	42161	arbitrum
Optimism	10	optimism
Avalanche	43114	avalanche
Base	8453	base

Quick Reference

Tool	Description
get_token_info	Token information
get_token_details	Detailed token data
get_tokens	Multiple tokens info
get_tokens_by_address	Token by address
get_multi_tokens	Up to 50 tokens
get_coin_metadata	CoinGecko metadata
get_new_tokens	Latest deployed tokens
get_recently_updated_tokens	Recently updated tokens
filter_tokens	Search/filter tokens
get_token_holders	Token holders list
get_token_top_holders	Top holders
get_token_holders_chart	Holder history chart
get_top_holders_percentage	Top 10 holder %
get_token_lifecycle_events	Mint/burn events
get_token_top_traders	Top traders