Hive Intelligence

Tools Reference

NFT Analytics Tools

NFT Analytics Tools

29 tools for NFT collection analytics, AMM pool data, and marketplace trading.

MCP Endpoint: POST /hive_nft_analytics/mcp

Data Sources: CoinGecko, Codex


Basic NFT Data (CoinGecko)

get_nfts

Query all supported NFTs with ID, contract address, name, and symbol.

ParameterTypeRequiredDescription
orderstringNoSort: h24_volume_usd_desc, floor_price_native_desc, market_cap_usd_desc
per_pagenumberNoResults per page (1-250)
pagenumberNoPage number

Example:

curl -X POST https://api.hiveintelligence.xyz/api/execute \
  -H "Content-Type: application/json" \
  -d '{
    "toolName": "get_nfts",
    "arguments": {
      "order": "h24_volume_usd_desc",
      "per_page": 10
    }
  }'

get_nft

Get NFT collection data including floor price and 24h volume.

ParameterTypeRequiredDescription
idstringYesNFT collection ID

Example:

curl -X POST https://api.hiveintelligence.xyz/api/execute \
  -H "Content-Type: application/json" \
  -d '{
    "toolName": "get_nft",
    "arguments": {
      "id": "bored-ape-yacht-club"
    }
  }'

get_nft_market_chart

Get historical market data for an NFT collection.

ParameterTypeRequiredDescription
idstringYesNFT collection ID
daysstringYesData for number of days (integer or "max")

NFT Pool Analytics (Codex)

Tools for analyzing NFT AMM pools on protocols like Sudoswap.

get_nft_pool

Get detailed information about a specific NFT liquidity pool.

ParameterTypeRequiredDescription
addressstringYesNFT pool address
networkIdnumberYesNetwork ID

Example:

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

Response includes:

  • Pool balance and spot price
  • NFT assets in pool
  • Fee structure
  • Trading statistics

get_nft_pool_events

Get transaction events for NFT pools including swaps, deposits, and withdrawals.

ParameterTypeRequiredDescription
networkIdnumberYesNetwork ID
collectionAddressstringNoFilter by NFT collection
poolAddressstringNoFilter by specific pool
exchangeAddressstringNoFilter by exchange
eventTypesarrayNoFilter by event types
limitnumberNoMaximum results
cursorstringNoPagination cursor
timestampobjectNo{from, to} Unix timestamps

get_nft_pool_collections_by_exchange

Get all NFT collections with liquidity pools on a specific exchange.

ParameterTypeRequiredDescription
exchangeAddressstringYesExchange address
networkIdnumberYesNetwork ID
limitnumberNoMaximum results
cursorstringNoPagination cursor

get_nft_pools_by_collection

Get all liquidity pools for a specific NFT collection.

ParameterTypeRequiredDescription
collectionAddressstringYesNFT collection address
exchangeAddressstringYesExchange address
networkIdnumberYesNetwork ID
limitnumberNoMaximum results
cursorstringNoPagination cursor

get_nft_pools_by_owner

Get all NFT pools owned by a specific wallet.

ParameterTypeRequiredDescription
ownerAddressstringYesOwner wallet address
networkIdnumberYesNetwork ID
exchangeAddressstringNoFilter by exchange
limitnumberNoMaximum results
cursorstringNoPagination cursor

get_nft_pool_stats

Get statistical data for NFT pools within a time range.

ParameterTypeRequiredDescription
collectionAddressstringYesNFT collection address
exchangeAddressstringYesExchange address
networkIdnumberYesNetwork ID
startTimenumberYesStart Unix timestamp
endTimenumberYesEnd Unix timestamp
poolAddressstringNoSpecific pool address

filter_nft_pools

Search and filter NFT liquidity pools by various criteria.

ParameterTypeRequiredDescription
filtersobjectNoPool filters (see below)
phrasestringNoSearch phrase
limitnumberNoMaximum results
offsetnumberNoPagination offset
rankingsarrayNoSort criteria

Filter options:

  • collectionAddress, exchangeAddress, ownerAddress
  • balanceNBT, balanceUSD - Liquidity filters
  • volumeNBT24, volumeUSD24 - Volume filters
  • network - Network IDs

Collection Analytics

get_nft_collection

Get comprehensive metadata and statistics for an NFT collection.

ParameterTypeRequiredDescription
addressstringNoCollection contract address
collectionIdstringNoCollection ID
networkIdnumberNoNetwork ID

Provide either address or collectionId


get_nft_collection_assets

Get individual NFT assets from a collection with metadata.

ParameterTypeRequiredDescription
addressstringYesCollection contract address
networkIdnumberYesNetwork ID
tokenIdsarrayNoSpecific token IDs
limitnumberNoMaximum results
cursorstringNoPagination cursor

get_nft_collection_stats

Get bucketed statistical data for NFT collections over time.

ParameterTypeRequiredDescription
collectionAddressstringYesCollection address
networkIdnumberYesNetwork ID
durationsarrayNoTime periods
bucketCountnumberNoNumber of data buckets
timestampnumberNoHistorical timestamp

get_nft_collection_events

Get transaction events for NFT collections including sales and transfers.

ParameterTypeRequiredDescription
networkIdnumberYesNetwork ID
addressstringNoCollection address
tokenIdstringNoSpecific token ID
exchangeAddressstringNoExchange filter
includeTransfersbooleanNoInclude transfers
limitnumberNoMaximum results
cursorstringNoPagination cursor
timestampobjectNo{from, to} Unix timestamps

get_nft_contracts

Get enhanced contract information for NFT collections.

ParameterTypeRequiredDescription
contractsarrayYesArray of {address, networkId} objects

get_nft_holders

Get holders of an NFT collection ordered by holdings.

ParameterTypeRequiredDescription
collectionAddressstringYesCollection address
networkIdnumberYesNetwork ID
cursorstringNoPagination cursor

Search & Discovery

filter_nft_collections

Search and filter NFT collections by various criteria.

ParameterTypeRequiredDescription
phrasestringNoSearch phrase
collectionsarrayNoCollection addresses to filter
filtersobjectNoAdvanced filters
limitnumberNoMaximum results
offsetnumberNoPagination offset
rankingsarrayNoSort criteria

Example:

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

filter_nft_pool_collections

Search NFT collections with liquidity pools on AMM marketplaces.

ParameterTypeRequiredDescription
phrasestringNoSearch phrase
filtersobjectNoPool collection filters
limitnumberNoMaximum results
offsetnumberNoPagination offset
rankingsarrayNoSort criteria

search_nfts

Search for NFTs across collections and marketplaces.

ParameterTypeRequiredDescription
searchstringNoSearch query
includearrayNoData types to include
networkFilterarrayNoNetwork IDs
filterWashTradingbooleanNoFilter wash trading
limitnumberNoMaximum results

Wallet NFT Tools

get_wallet_nfts

Get NFTs held by a wallet address.

ParameterTypeRequiredDescription
walletAddressstringYesWallet address
networkIdnumberNoNetwork ID
cursorstringNoPagination cursor

get_wallet_all_nfts

Get all NFTs across all collections for a wallet.

ParameterTypeRequiredDescription
walletAddressstringYesWallet address
cursorstringNoPagination cursor

Additional NFT Tools

get_nft_collections

Get list of NFT collections with market data.

ParameterTypeRequiredDescription
networkIdnumberNoFilter by network
limitnumberNoMaximum results
cursorstringNoPagination cursor

get_nft_collection_analysis

Get detailed analysis for an NFT collection.

ParameterTypeRequiredDescription
collectionAddressstringYesCollection address
networkIdnumberYesNetwork ID

Get NFT market trend data and analytics.

ParameterTypeRequiredDescription
timeframestringNoTime period for trends
networkIdnumberNoFilter by network

get_prime_holders

Get holders of Prime ecosystem assets.

ParameterTypeRequiredDescription
networkIdnumberYesNetwork ID
poolAddressstringNoFilter by pool
limitnumberNoMaximum results
cursorstringNoPagination cursor

Prime Ecosystem

Tools for Prime ecosystem pools and assets.

get_prime_pools

Get information about Prime ecosystem pools.

ParameterTypeRequiredDescription
addressstringYesPool address
networkIdnumberYesNetwork ID
limitnumberNoMaximum results
cursorstringNoPagination cursor

get_prime_pool_assets

Get assets in Prime ecosystem pools.

ParameterTypeRequiredDescription
networkIdnumberYesNetwork ID
poolContractAddressstringNoPool contract address
poolIdstringNoPool ID
walletAddressstringNoWallet address
limitnumberNoMaximum results
cursorstringNoPagination cursor

get_prime_pool_events

Get events for Prime ecosystem pools.

ParameterTypeRequiredDescription
networkIdnumberYesNetwork ID
eventTypesarrayNoEvent types to filter
poolContractAddressstringNoPool contract
poolIdstringNoPool ID
walletAddressstringNoWallet address
limitnumberNoMaximum results
cursorstringNoPagination cursor

Parallel Trading Cards

Tools for Parallel trading card game assets.

filter_parallel_assets

Search and filter Parallel trading card assets.

ParameterTypeRequiredDescription
phrasestringNoSearch phrase
filtersobjectNoAsset filters
matchobjectNoMatching criteria
limitnumberNoMaximum results
offsetnumberNoPagination offset
rankingsarrayNoSort criteria

get_parallel_card_changes

Get changes to Parallel trading card metadata over time.

ParameterTypeRequiredDescription
parallelIdnumberNoSpecific card ID
limitnumberNoMaximum results
cursorstringNoPagination cursor

Quick Reference

ToolDescription
get_nftNFT collection data
get_nftsList all supported NFTs
get_nft_market_chartHistorical market data
get_wallet_nftsWallet NFT holdings
get_wallet_all_nftsAll wallet NFTs
get_nft_collectionCollection metadata
get_nft_poolNFT pool details
get_nft_pool_eventsPool transaction events
get_nft_pool_statsPool statistics
get_nft_pool_collections_by_exchangeCollections on exchange
get_nft_pools_by_collectionPools for collection
get_nft_pools_by_ownerPools by owner
filter_nft_collectionsFilter collections
filter_nft_pool_collectionsFilter pool collections
search_nftsSearch NFTs
filter_nft_poolsFilter pools
get_nft_collection_assetsCollection assets
get_nft_collection_statsCollection statistics
get_nft_collection_eventsCollection events
get_nft_contractsContract info
get_nft_holdersCollection holders
get_nft_collectionsNFT collections list
get_nft_collection_analysisCollection analysis
get_nft_market_trendsMarket trend data
get_prime_poolsPrime pools
get_prime_pool_assetsPrime pool assets
get_prime_pool_eventsPrime pool events
get_prime_holdersPrime holders
filter_parallel_assetsParallel card assets
get_parallel_card_changesCard change history
Previous
Token & Contract