Dex Token Market Data

Pulls live decentralized-exchange (DEX) pair market data from Dexscreener's free public API: price, price change, volume, liquidity, FDV, and market cap for any token or pair across every chain Dexscreener indexes.

This is raw market data only — not financial or investment advice. It does not evaluate, rank, or recommend any token. Verify any price or figure against the source before acting on it.

Input

Field	Type	Description
queries	array of strings (required)	Each entry is either a free-text search term (a token symbol or name, e.g. "PEPE") or "chainId:tokenAddress" (e.g. "ethereum:0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2") to pull every pool for that token.
maxPairsPerQuery	integer (default 30)	Max pair rows returned per query, ranked by Dexscreener.

The default input (queries: ["WETH"]) returns real, non-empty results.

Output

One dataset row per DEX pair:

{
  "chainId": "solana",
  "dexId": "orca",
  "pairAddress": "HktfL7iwGKT5QHjywQkcDnZXScoh811k7akrMZJkCcEF",
  "url": "https://dexscreener.com/solana/hktfl7iwgkt5qhjywqkcdnzxscoh811k7akrmzjkccef",
  "baseTokenSymbol": "WETH",
  "baseTokenAddress": "7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs",
  "quoteTokenSymbol": "SOL",
  "quoteTokenAddress": "So11111111111111111111111111111111111111112",
  "priceUsd": "2412.11",
  "priceNative": "24.1912",
  "priceChangeM5": -0.11,
  "priceChangeH1": -0.23,
  "priceChangeH6": -0.41,
  "priceChangeH24": -2.06,
  "volumeH24": 7489724.74,
  "liquidityUsd": 6047274.06,
  "fdv": 210022972,
  "marketCap": 210022972,
  "pairCreatedAt": "2022-11-28T02:25:41.000Z"
}

All addresses returned are smart-contract/token-mint and liquidity-pool addresses (protocol data), never a wallet or personal address of an individual.

Pricing

Pay-per-event: $0.0012 per pair-row pushed to the dataset ($1.20 per 1,000 rows), no start or end fee. Charged once per row; nothing is charged for a query that returns zero pairs.

Limits / known gaps

• Data is only as fresh as Dexscreener's own indexing (typically seconds to a couple of minutes behind on-chain state).
• Dexscreener does not document a hard SLA; this actor paces requests under their documented 300 req/min limit for pair-data endpoints.
• New or extremely low-liquidity pairs may be missing or delisted between runs — that's Dexscreener's indexing, not this actor.
• Free-text search quality is Dexscreener's own ranking; for a specific token, the chainId:tokenAddress form is more precise.