# Vextorium DEX Pairs Lookup

> Vextorium DEX Pairs Lookup is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-11).

Looks up decentralized exchange trading pairs for a given token across Solana and EVM chains, returning price, liquidity, volume, and market cap data.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/dex-pairs?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-dex-pairs-lookup-aa304683
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mx0pEBvfz9sQ_11MSPYz9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vextorium-dex-pairs-lookup-aa304683 -d '<json body>'
```

Example prompt: Find me the top 5 DEX trading pairs for USDC on Base — I want to see the price, liquidity, and 24-hour volume for each pair.

## When to prefer this

Use this endpoint when you need real-time DEX trading pair data including liquidity, volume, and price for any token on Solana or EVM chains. Prefer it over centralized exchange APIs when researching DeFi tokens or assessing on-chain liquidity risk. It is especially useful for tokens not listed on centralized exchanges that are only tradable on DEXes.

## Known failure modes

- Token not found — returns empty pairs array or found:0 if the symbol/address does not match any tracked pair
- Invalid chain name — may return no results or unfiltered results if chain string is unrecognized
- Limit out of range — rejected if limit is outside 1–30
- Upstream DEX Screener unavailability — may return error or stale data if the underlying data source is down
- Ambiguous token symbol — common symbols like 'USD' may return many unrelated pairs across chains

## How this service works

Trading pairs for a token across all chains (by symbol, name or address): price, 24h/1h change, on-chain liquidity, 24h volume, market cap, DEX and chain. Filter by chain (use the token address for a precise per-chain view). Live from DEX Screener.

## Output

Returns a JSON object containing the total number of matching pairs found, the queried token, the chain filter applied, the data source, and an array of up to 30 pairs. Each pair includes the DEX name, trading pair symbol, chain, current price in USD, 1-hour and 24-hour price change percentages, liquidity in USD, 24-hour volume in USD, market cap in USD, token contract address, and a direct link to the pair on DEX Screener. Results are sorted by liquidity descending, with a disclaimer that low liquidity indicates higher manipulation risk.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "token"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "Filter by chain, e.g. base, solana, ethereum (optional)"
      },
      "limit": {
       "type": "integer",
       "maximum": 30,
       "minimum": 1,
       "description": "Pairs to return (1-30, default 6)"
      },
      "token": {
       "type": "string",
       "description": "Token symbol, name or address"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "note": {
       "type": [
        "string",
        "null"
       ]
      },
      "chain": {
       "type": [
        "string",
        "null"
       ]
      },
      "found": {
       "type": [
        "number",
        "null"
       ]
      },
      "pairs": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "dex": {
          "type": [
           "string",
           "null"
          ]
         },
         "link": {
          "type": [
           "string",
           "null"
          ]
         },
         "pair": {
          "type": [
           "string",
           "null"
          ]
         },
         "chain": {
          "type": [
           "string",
           "null"
          ]
         },
         "price_usd": {
          "type": [
           "number",
           "null"
          ]
         },
         "change_1h_pct": {
          "type": [
           "number",
           "null"
          ]
         },
         "liquidity_usd": {
          "type": [
           "number",
           "null"
          ]
         },
         "token_address": {
          "type": [
           "string"
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Pairs sorted by liquidity. Low liquidity = more manipulation risk. Not investment advice.",
  "chain": "base",
  "found": 1,
  "pairs": [
   {
    "dex": "quickswap",
    "link": "https://dexscreener.com/base/0x5d0bc342178c8fe2c2f9a9fcc9d52555c99936db",
    "pair": "USDC/USDbC",
    "chain": "base",
    "price_usd": 0.9998,
    "change_1h_pct": -0.01,
    "liquidity_usd": 108600,
    "token_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "change_24h_pct": -0.01,
    "market_cap_usd": 60893549651,
    "volume_24h_usd": 173389
   }
  ],
  "query": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "source": "DEX Screener (api.dexscreener.com, open data)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-dex-pairs-lookup-aa304683/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)