# Dextools API MCP > Dextools (DeFi Token Data API) gives your agent real-time access to market data across dozens of blockchains. Check current token prices, analyze liquidity pools, and pull deep metadata on any DeFi asset. This lets you track cross-chain activity without leaving your workflow. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** defi, token-data, crypto-prices, liquidity-pools, dex-analytics ## Description Need to figure out the health of a decentralized finance market? You don't want to jump between five different DEX explorers just to get a clear picture. This MCP connects your agent directly to Dextools, giving it immediate access to token metrics and liquidity pool data across major networks like Ethereum, Polygon, and BSC. Instead of manually checking prices or fetching supply details one by one, you can simply ask your client to gather all the necessary background info for research or development. For example, if you want to check market depth on a specific pair, it handles that instantly. And if you just need to know what blockchains are available in the ecosystem, there's a tool for that too. This entire catalog of data is hosted and managed by Vinkius, so once you connect your preferred AI client, you get access to all this market intelligence, period. ## Tools ### get_blockchains Lists all the supported blockchain networks that the API can access data from. ### get_pair Retrieves specific details about a given liquidity pair on a chain. ### get_token_liquidity Calculates the total market depth and health metrics for a specific token or pair. ### get_token_price Gathers the current trading price of a token along with its 24-hour percentage change. ### get_token Pulls detailed information, like supply and decimals, for any specified token contract. ## Prompt Examples **Prompt:** ``` List all supported blockchain networks on Dextools. ``` **Response:** ``` I've retrieved the supported chains. Dextools currently supports networks including Ethereum (ether), Binance Smart Chain (bsc), Polygon (polygon), Solana (solana), and many others. Which one would you like to explore? ``` **Prompt:** ``` Get the current price and 24h change for token 0x... on Ethereum. ``` **Response:** ``` Fetching price data... The token at that address is currently trading at $1.24 with a +5.2% increase over the last 24 hours on the Ethereum network. ``` **Prompt:** ``` Show me the liquidity information for the pair 0x... on BSC. ``` **Response:** ``` Analyzing liquidity... For the specified pair on Binance Smart Chain, the total liquidity is approximately $500,000 USD. Would you like to see the individual token reserves for this pool? ``` ## Capabilities ### Identify supported blockchains Retrieves a definitive list of every network the API supports right now. ### Analyze token metadata Pulls deep information on any specific token, including its total supply and decimal count. ### Track real-time pricing Gathers the current trading price and the percentage change for a token over 24 hours. ### Assess pool liquidity Inspecting specific pair addresses to determine the total market depth and health of that pool. ## Use Cases ### Auditing cross-chain investment viability A crypto analyst needs to compare the liquidity health of a new token across Ethereum and Polygon. They ask their agent to use `get_token_liquidity` for both chains, which gives them a comparative report without needing to open two different web tabs. ### Building an automated portfolio monitor A developer wants to write a script that checks if a token's price has moved too much. They use `get_token` first to validate the contract, then run `get_token_price` to get the real-time 24h change percentage. ### Quickly evaluating a DeFi opportunity A trader hears about a new farming pair. Instead of guessing, they ask their agent to use `get_pair` and `get_token_liquidity`. The response immediately tells them if the pool is deep enough for serious capital. ### Validating market scope for research A researcher needs to know if a certain type of asset exists on Solana or BSC. They first use `get_blockchains` to confirm support, then follow up with `get_token` to pull the metadata for their specific query. ## Benefits - You stop manually checking multiple dashboards. By using the `get_token_price` tool, your agent provides instant 24-hour price changes and current valuations for any token you specify. - No more guessing about which chains are supported. The `get_blockchains` tool gives a definitive list of all networks, letting you scope out exactly where you need to look next. - You can verify the foundational details of an asset using `get_token`. This means knowing the token's total supply and decimal count before calculating anything else. - Understanding market depth used to be painful. Now, by running `get_token_liquidity`, your agent shows you the true health and size of a specific liquidity pool. - Need to compare two assets? The API lets you check both the general token data via `get_token` and then refine that comparison by checking details on a specific pair using `get_pair`. ## How It Works The bottom line is that you get automated access to complex DeFi data without writing boilerplate API calls yourself. 1. First, subscribe to this MCP on Vinkius and enter your Dextools API Key. 2. Next, connect your unique key through your AI client (Claude, Cursor, etc.). 3. Finally, you just ask your agent a question, like 'What's the current price for token X?' — and it runs the query for you. ## Frequently Asked Questions **How do I know which blockchains are supported with the Dextools (DeFi Token Data API)?** You run the `get_blockchains` tool. It returns a full list of all network identifiers that the platform supports, so you can scope your research immediately. **Do I need to know the token's contract address before using get_token_price?** Yes, the current price tool requires a specific token contract address. You should use `get_token` first if you aren't sure about the full metadata or supply details of that asset. **What is the difference between get_pair and get_token_liquidity?** The `get_pair` tool gives basic identifying information about two tokens in a pool. The `get_token_liquidity` tool takes that info and calculates the actual market depth, telling you how much capital is available. **Can I find out what a token's total supply using get_token?** Yes, that's one of its core functions. The `get_token` tool pulls detailed metadata about the asset, including its total supply and decimal count. **If I run `get_token` but it returns an error, what does that mean for the token's data?** It means the requested metadata couldn't be found or accessed. Check if the contract address is correct or if the token simply doesn't exist on that specific chain. The tool will usually specify a missing field or invalid input. **When I use `get_pair`, does it provide enough details to confirm which tokens are involved?** Yes, `get_pair` returns the contract addresses for both assets. This allows you to verify exactly what two token contracts form that specific liquidity pair. **After running the `get_blockchains` tool, how do I make sure my subsequent calls are on the correct network?** You must pass the desired network ID or name explicitly in your next call. Don't assume the default chain; always confirm the chain context to avoid getting data from the wrong blockchain. **If I need to track prices for dozens of tokens, how do I manage the volume and potential rate limits?** For bulk requests, your agent should batch calls or loop through addresses. Keep an eye on any specific rate limit warnings from the API documentation; continuous high-volume querying might require throttling. **Can I check the current price of a token on a specific blockchain?** Yes! Use the `get_token_price` tool by providing the blockchain identifier (e.g., 'ether') and the token's contract address. It will return the current price and 24h variation. **How do I see which networks Dextools currently supports?** Simply run the `get_blockchains` tool. It will provide a complete list of all blockchain networks integrated with the Dextools API. **Is it possible to analyze the liquidity of a specific trading pair?** Absolutely. You can use `get_token_liquidity` with the pair address or `get_pair` to fetch comprehensive data about liquidity pools, including volume and health metrics.