Liquidity analysis
get_liquidityLiquidity pool analysis for one token: which DEX holds the deepest pool, its depth in USD, and whether the LP tokens are burned, locked or still in someone's hands. lpStatus is the verdict — LP BURNED, LP LOCKED, LP UNLOCKED, PARTIALLY BURNED, LP NOT LOCKABLE, LP MULTI-PROVIDER (a pool with no LP token whose positions are split between independent providers, none holding a fifth of the liquidity), BONDING CURVE (still on a launchpad curve, no pool yet) or NO LP FOUND, with combinations spelled out — and lpBurnPct, lpLockPct, poolLocks and positionLock carry the evidence. Use it to answer whether liquidity is locked, how deep it is, and whether the position could be pulled: LP UNLOCKED means it can be pulled at any time. Cached for about two minutes. A token with no pool returns empty liquidity data, which is itself a warning on a token that is trading. Not for price or volume (get_token_price), market cap (get_token_scan) or holder concentration (get_holders). Arguments: address and chain — pools live per chain, so a 0x address needs the chain it trades on, and a Base pool is not found under ethereum; one API unit on any chain.
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": {
"address": "<address>"
},
"name": "get_liquidity"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Chain the token is deployed on: solana (default), ethereum, base, bsc, robinhood, arc, hyperevm, monad, elysium. Required for any 0x address, because the same contract address can exist on several EVM chains. Omit it for Solana. An unsupported value is rejected before any request is spent; EVM chains need a key on an All-Chains plan. | solana |
| address | Yes | The token's own contract address, exactly as an explorer shows it. Solana: the base58 mint, 32-44 characters (e.g. 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN). EVM: 0x followed by 40 hex characters, case-insensitive (e.g. 0x6982508145454ce325ddbe47a25d4ec3d2311933). Never a pool, pair, wallet or deployer address — those come back as not found. Set `chain` to match the address: a 0x address alone cannot say which EVM chain it lives on, and a Solana mint sent with an EVM chain is rejected. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dex | No | Which DEX holds the deepest pool. | |
| risk | No | Liquidity risk label; lpEvidence carries the on-chain evidence behind it. | |
| token | No | The address that was scanned (on get_token_scan, the full token metadata object instead). | |
| lpStatus | No | Headline pool verdict: LP BURNED, LP LOCKED, LP UNLOCKED, PARTIALLY BURNED, LP NOT LOCKABLE, LP MULTI-PROVIDER (no LP token, and its positions are split between independent providers, none holding a fifth of the liquidity), LP HELD BY DAO (a MetaDAO token: the vault of its DAO holds the liquidity), BONDING CURVE, NO LP FOUND, or a spelled-out combination. | |
| lpBurnPct | No | Percent of LP tokens burned; lpLockPct is the percent locked. | |
| poolLocks | No | Per-pool lock detail with lpLockable and an lpNote in words. | |
| poweredBy | No | Always "DeFade.org". | |
| timestamp | No | ISO time the response was assembled. | |
| positionLock | No | A main pool with no LP token (Solana: Orca, Meteora DLMM, Raydium CLMM; EVM: v3/v4): who holds its positions, read on chain. largestOpenOwner (address, pct) is the largest single provider's share of ALL the liquidity; lockedPct, burnedPct and unknownPct (not read) are shares of it too; on Solana creator (address, pct) is the creator's share and perPool the pools read. Null when the main pool has an LP token. | |
| totalLiquidityUsd | No | Combined USD depth across pools; pools lists them and poolCount counts them. On an EVM chain, null when the pair feed gives no pool a liquidity figure, or the reserve of a bonding curve could not be priced: unknown, not zero. |