DEX Pool Liquidity Depth
Fetch live pair price, liquidity, volume, and price-change fields for a DEX pool address from DexScreener.
Preview request
The preview path is rate-limited and does not charge. It executes the live source and returns the paid response shape while withholding decision-ready values. Production requests use the same parameters and return a standard x402 challenge when no payment signature is present.
curl --request GET \ "https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/pool_liquidity?preview=true&chain=base&pool_address=0xd0b53D9277642d899DF5C87A3966A349A798F224"
Input contract
| Parameter | Type | Required | Description |
|---|---|---|---|
pool_address | string | Yes | DEX pair contract address to look up. |
chain | string | No | DexScreener chain id, for example base or ethereum. Defaults to ethereum. |
Example deliverable
This is the documented response shape, not a promise that live values will match the example. The paid request returns current or declared-source results using the same contract.
{
"success": true,
"source": "DexScreener pair API",
"fetched_at": "2026-08-07T07:32:32.117Z",
"count": 1,
"pairs": [
{
"chain_id": "base",
"dex_id": "uniswap",
"pair_address": "0xd0b53D9277642d899DF5C87A3966A349A798F224",
"base_token": {
"address": "0x4200000000000000000000000000000000000006",
"name": "Wrapped Ether",
"symbol": "WETH"
},
"quote_token": {
"address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"name": "USD Coin",
"symbol": "USDC"
},
"price_usd": "1904.71",
"liquidity": {
"usd": 10122484.11,
"base": 3744.3599,
"quote": 2990560
},
"volume": {
"h24": 6689716.93,
"h6": 1340020.27,
"h1": 86668.32,
"m5": 2064.61
},
"price_change": {
"m5": -0.01,
"h1": 0.06,
"h6": 0.05,
"h24": -0.3
},
"pair_created_at": 1694030161000,
"url": "https://dexscreener.com/base/0xd0b53d9277642d899df5c87a3966a349a798f224"
}
],
"marketplace_metadata": {
"data_mode": "live_source",
"billable": true,
"availability": "operational",
"source": "DexScreener pair API"
}
}Purchase decision
Buy when: the active task needs this product's structured result, its declared source and freshness are sufficient, and 0.05 USDC is within the buyer's authorized per-request limit.
Skip when: a cached result is sufficient, the source or fields do not satisfy the task, or the buyer has not authorized payment. Do not bypass wallet, budget, or user-approval policy.
Guaranteed response metadata
Every successful product response identifies how the result was produced. Product-specific output fields are documented in the paid OpenAPI contract. The preview proves the live source and field types without returning the paid values.
{
"marketplace_metadata": {
"data_mode": "live_source",
"billable": true,
"availability": "operational",
"source": "DexScreener pair API"
}
}Agent payment flow
Fast path: install the public MCP package, configure a dedicated low-balance Base buyer wallet and a maximum per-request spend, then call this tool with auto_pay: true. The client handles the challenge, local signature, settlement, and retry in one tool call.
npx -y dopaminedesk-ai-data-marketplace-mcp
X402_AUTO_PAY=true
X402_EVM_PRIVATE_KEY=<dedicated buyer wallet key>
X402_MAX_PAYMENT_USDC=0.25
tool input: { "auto_pay": true }Manual path: request the product, read the base64 PAYMENT-REQUIRED challenge, sign with any compatible x402 v2 client, and retry with PAYMENT-SIGNATURE. A successful response includes PAYMENT-RESPONSE.