# DEX Screener

> Track what is trading on decentralised exchanges with DEX Screener's free public data, across a hundred-odd blockchains. Search for a token by name, price thirty at once, open a single pool, list every pool a token trades in, and follow the new token profiles, boosts, community takeovers, ads and trending narratives. Any dexscreener.com link can be pasted in place of a chain and an address, and every result comes back with one. No account or API key is required.

App · Cryptocurrency · 11 actions. Web page: https://docs.lodol.com/docs/integrations/dexscreener

## Actions

### Check a token's paid orders

See what a token's team has paid DEX Screener for (a profile, a community takeover, an ad or a trending-bar slot) and whether each order was approved, is still processing, or was rejected. A token that has bought nothing comes back empty rather than as an error.

**Inputs**

- Chain (`chain`, text, required): Which blockchain the token is on. Pick it from the list, or type the chain id DEX Screener uses for any other chain: it is the first part of the address in every dexscreener.com link.
- Token (`token`, text, required): The token's contract address, or its dexscreener.com link: a link carries the chain too, so pasting one is enough on its own. Every step here returns a link, so one step can hand a token to the next.

**Outputs**

- `approved_count` (number): How many of them were approved.
- `approved_types` (list): What this token actually has running, in words.
- `chain` (text): That chain's name.
- `chain_id` (text): The chain the token is on.
- `count` (number): How many there are.
- `dexscreener_url` (text): The token's page.
- `latest_order` (object): The most recent order.
- `note` (text): Set only when something needs saying -- results trimmed, a chain with nothing on it, a token with no price. Empty otherwise.
- `orders` (list): The orders, most recent first.
- `token_address` (text): The token's contract address.

**Example output**

```json
{
  "approved_count": 1,
  "approved_types": [
    "Token profile"
  ],
  "chain": "Solana",
  "chain_id": "solana",
  "count": 1,
  "dexscreener_url": "https://dexscreener.com/solana/6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
  "latest_order": {
    "paid_at": "2026-09-10T21:47:30Z",
    "status": "approved",
    "type": "tokenProfile",
    "type_label": "Token profile"
  },
  "note": null,
  "orders": [
    {
      "paid_at": "2026-09-10T21:47:30Z",
      "status": "approved",
      "type": "tokenProfile",
      "type_label": "Token profile"
    }
  ],
  "token_address": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"
}
```

### Get a meta

Open one narrative and see the pools of the tokens in it, deepest first, alongside what the whole meta is worth and how far it has moved. Pick the meta from the list of what is trending, or use a slug 'List trending metas' returned.

**Inputs**

- Meta (`meta`, text, required): Which narrative to open. Pick it from the trending list, or type the slug of any other one.
- How many pools (`limit`, number): How many of the meta's pools to return, deepest first. From 1 to 100. Default: `20`.

**Outputs**

- `description` (text): What the narrative is.
- `dexscreener_url` (text): The meta's page on dexscreener.com.
- `found` (true/false): Whether a meta with that slug exists.
- `icon_type` (text): Whether its mark is an emoji or an image.
- `icon_value` (text): The emoji, or the image's address.
- `liquidity_usd` (number): What their pools hold together.
- `market_cap_change_1h_percent` (number): How far it moved in an hour.
- `market_cap_change_24h_percent` (number): How far it moved in 24 hours.
- `market_cap_change_5m_percent` (number): How far that total moved in five minutes.
- `market_cap_change_6h_percent` (number): How far it moved in six hours.
- `market_cap_delta_1h_usd` (number): Over an hour.
- `market_cap_delta_24h_usd` (number): Over 24 hours.
- `market_cap_delta_5m_usd` (number): That move in dollars, over five minutes.
- `market_cap_delta_6h_usd` (number): Over six hours.
- `market_cap_usd` (number): What every token in the meta is worth together.
- `name` (text): Its name, such as AI Agents.
- `note` (text): Set only when something needs saying -- results trimmed, a chain with nothing on it, a token with no price. Empty otherwise.
- `pair_count` (number): How many pools are listed here.
- `pairs` (list): The meta's pools, deepest first.
- `slug` (text): How DEX Screener addresses this meta. The Meta field takes it, so one step can hand a meta to the next.
- `token_count` (number): How many tokens are in it.
- `top_pair` (object): Its deepest pool.
- `total_pairs` (number): How many the meta has in all.
- `volume_usd` (number): Dollars traded across them.

**Example output**

```json
{
  "description": "Tokens for autonomous agents that trade, post and build.",
  "dexscreener_url": "https://dexscreener.com/metas/ai-agents",
  "found": true,
  "icon_type": "emoji",
  "icon_value": "\ud83e\udd16",
  "liquidity_usd": 184000000.0,
  "market_cap_change_1h_percent": -0.84,
  "market_cap_change_24h_percent": 7.63,
  "market_cap_change_5m_percent": 0.12,
  "market_cap_change_6h_percent": 2.41,
  "market_cap_delta_1h_usd": -40700000.0,
  "market_cap_delta_24h_usd": 341900000.0,
  "market_cap_delta_5m_usd": 5800000.0,
  "market_cap_delta_6h_usd": 113400000.0,
  "market_cap_usd": 4820000000.0,
  "name": "AI Agents",
  "note": null,
  "pair_count": 1,
  "pairs": [
    {
      "active_boosts": null,
      "age_days": 2011.3,
      "base_token_address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
      "base_token_name": "Wrapped Ether",
      "base_token_symbol": "WETH",
      "buy_sell_ratio_24h": 1.0502,
      "buys_24h": 48213,
      "chain": "Ethereum",
      "chain_id": "ethereum",
      "created_at": "2021-03-12T18:04:11Z",
      "dex": "uniswap",
      "dexscreener_url": "https://dexscreener.com/ethereum/0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640",
      "fdv": 110400000000.0,
      "image_url": "https://dd.dexscreener.com/ds-data/tokens/solana/So11111111111111111111111111111111111111112.png",
      "labels": [
        "v3"
      ],
      "liquidity_base": 22860.0,
      "liquidity_quote": 4210000.0,
      "liquidity_usd": 41200000.0,
      "market_cap": 98700000000.0,
      "pair": "WETH/USDC",
      "pair_address": "0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640",
      "price_change_1h_percent": -0.31,
      "price_change_24h_percent": 3.47,
      "price_change_5m_percent": 0.04,
      "price_change_6h_percent": 1.12,
      "price_native": 3142.88,
      "price_usd": 3142.88,
      "quote_token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "quote_token_name": "USD Coin",
      "quote_token_symbol": "USDC",
      "sells_24h": 45907,
      "socials": [
        {
          "handle": "solana",
          "label": "Twitter",
          "url": "https://x.com/solana"
        }
      ],
      "txns_24h": 94120,
      "volume_1h_usd": 2841000.0,
      "volume_24h_usd": 128500000.0,
      "volume_5m_usd": 214500.0,
      "volume_6h_usd": 15230000.0,
      "websites": [
        {
          "label": "solana.com",
          "url": "https://solana.com"
        }
      ]
    }
  ],
  "slug": "ai-agents",
  "token_count": 312,
  "top_pair": {
    "active_boosts": null,
    "age_days": 2011.3,
    "base_token_address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
    "base_token_name": "Wrapped Ether",
    "base_token_symbol": "WETH",
    "buy_sell_ratio_24h": 1.0502,
    "buys_24h": 48213,
    "chain": "Ethereum",
    "chain_id": "ethereum",
    "created_at": "2021-03-12T18:04:11Z",
    "dex": "uniswap",
    "dexscreener_url": "https://dexscreener.com/ethereum/0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640",
    "fdv": 110400000000.0,
    "image_url": "https://dd.dexscreener.com/ds-data/tokens/solana/So11111111111111111111111111111111111111112.png",
    "labels": [
      "v3"
    ],
    "liquidity_base": 22860.0,
    "liquidity_quote": 4210000.0,
    "liquidity_usd": 41200000.0,
    "market_cap": 98700000000.0,
    "pair": "WETH/USDC",
    "pair_address": "0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640",
    "price_change_1h_percent": -0.31,
    "price_change_24h_percent": 3.47,
    "price_change_5m_percent": 0.04,
    "price_change_6h_percent": 1.12,
    "price_native": 3142.88,
    "price_usd": 3142.88,
    "quote_token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "quote_token_name": "USD Coin",
    "quote_token_symbol": "USDC",
    "sells_24h": 45907,
    "socials": [
      {
        "handle": "solana",
        "label": "Twitter",
        "url": "https://x.com/solana"
      }
    ],
    "txns_24h": 94120,
    "volume_1h_usd": 2841000.0,
    "volume_24h_usd": 128500000.0,
    "volume_5m_usd": 214500.0,
    "volume_6h_usd": 15230000.0,
    "websites": [
      {
        "label": "solana.com",
        "url": "https://solana.com"
      }
    ]
  },
  "total_pairs": 312,
  "volume_usd": 921000000.0
}
```

### Get a pool

Look up one trading pool: its price in dollars and in the token it trades against, how far it has moved over five minutes, an hour, six hours and a day, what it holds, what changed hands, how many buys and sells there were, and how old the pool is. Paste the pool's dexscreener.com link and the chain is read from it.

**Inputs**

- Pool (`pair`, text, required): The pool's address, or its dexscreener.com link: a link carries the chain too, so pasting one is enough on its own.
- Chain (`chain`, text): Which blockchain the token is on. Pick it from the list, or type the chain id DEX Screener uses for any other chain: it is the first part of the address in every dexscreener.com link. Leave it empty if you pasted a link, which already says which chain.

**Outputs**

- `active_boosts` (number): How many boosts are running on this token.
- `age_days` (number): How many days ago that was. This is what 'only pools opened this week' filters on.
- `base_token_address` (text): The address of the token being bought and sold.
- `base_token_name` (text): That token's name.
- `base_token_symbol` (text): Its ticker symbol.
- `buy_sell_ratio_24h` (number): Buys divided by sells. Empty when nothing sold, since there is no ratio to give.
- `buys_24h` (number): How many buys there were in 24 hours.
- `chain` (text): That chain's name, such as Solana.
- `chain_id` (text): The chain this pool is on, as DEX Screener spells it. Any Chain field takes it, so one step can hand a chain to the next.
- `created_at` (text): When the pool was opened, UTC.
- `dex` (text): Which exchange the pool is on, such as raydium or uniswap.
- `dexscreener_url` (text): The pool's page on dexscreener.com. Paste it into any Token or Pool field and both the chain and the address are read from it.
- `fdv` (number): Every token that will ever exist, at this price.
- `found` (true/false): Whether the pool exists. DEX Screener answers for an unknown pool with an empty result rather than an error, so this is how a workflow tells them apart.
- `image_url` (text): The token's logo.
- `labels` (list): How the exchange labels the pool.
- `liquidity_base` (number): How many base tokens it holds.
- `liquidity_quote` (number): How many quote tokens it holds.
- `liquidity_usd` (number): What the pool holds, in dollars.
- `market_cap` (number): Every token in circulation, at this price.
- `note` (text): Set only when something needs saying -- results trimmed, a chain with nothing on it, a token with no price. Empty otherwise.
- `pair` (text): What trades against what, such as SOL/USDC.
- `pair_address` (text): The pool's own address on the chain.
- `price_change_1h_percent` (number): How far it moved in an hour.
- `price_change_24h_percent` (number): How far it moved in 24 hours.
- `price_change_5m_percent` (number): How far the price moved in five minutes.
- `price_change_6h_percent` (number): How far it moved in six hours.
- `price_native` (number): What one base token costs in quote tokens.
- `price_usd` (number): What one base token costs in US dollars. This is always the base token's price, never the quote token's.
- `quote_token_address` (text): The address of the token it is priced in.
- `quote_token_name` (text): That token's name.
- `quote_token_symbol` (text): Its ticker symbol.
- `sells_24h` (number): How many sells there were.
- `socials` (list): Its social accounts.
- `txns_24h` (number): Both together.
- `volume_1h_usd` (number): Dollars traded in an hour.
- `volume_24h_usd` (number): Dollars traded in 24 hours.
- `volume_5m_usd` (number): Dollars traded in this pool in five minutes.
- `volume_6h_usd` (number): Dollars traded in six hours.
- `websites` (list): The project's websites.

**Example output**

```json
{
  "active_boosts": null,
  "age_days": 2011.3,
  "base_token_address": "So11111111111111111111111111111111111111112",
  "base_token_name": "Wrapped SOL",
  "base_token_symbol": "SOL",
  "buy_sell_ratio_24h": 1.0502,
  "buys_24h": 48213,
  "chain": "Solana",
  "chain_id": "solana",
  "created_at": "2021-03-12T18:04:11Z",
  "dex": "raydium",
  "dexscreener_url": "https://dexscreener.com/solana/58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
  "fdv": 110400000000.0,
  "found": true,
  "image_url": "https://dd.dexscreener.com/ds-data/tokens/solana/So11111111111111111111111111111111111111112.png",
  "labels": [],
  "liquidity_base": 22860.0,
  "liquidity_quote": 4210000.0,
  "liquidity_usd": 8420000.0,
  "market_cap": 98700000000.0,
  "note": null,
  "pair": "SOL/USDC",
  "pair_address": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
  "price_change_1h_percent": -0.31,
  "price_change_24h_percent": 3.47,
  "price_change_5m_percent": 0.04,
  "price_change_6h_percent": 1.12,
  "price_native": 184.21,
  "price_usd": 184.21,
  "quote_token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "quote_token_name": "USD Coin",
  "quote_token_symbol": "USDC",
  "sells_24h": 45907,
  "socials": [
    {
      "handle": "solana",
      "label": "Twitter",
      "url": "https://x.com/solana"
    }
  ],
  "txns_24h": 94120,
  "volume_1h_usd": 2841000.0,
  "volume_24h_usd": 61840000.0,
  "volume_5m_usd": 214500.0,
  "volume_6h_usd": 15230000.0,
  "websites": [
    {
      "label": "solana.com",
      "url": "https://solana.com"
    }
  ]
}
```

### Get token prices

Price a list of tokens on one chain in a single request. Use this rather than one step per token: thirty tokens cost exactly what one does. Each token's price comes from its deepest pool, its liquidity and volume are added up across the pools it is the base token of, and any token DEX Screener has no pools for is listed separately rather than quietly left out.

**Inputs**

- Chain (`chain`, text, required): Which blockchain the token is on. Pick it from the list, or type the chain id DEX Screener uses for any other chain: it is the first part of the address in every dexscreener.com link.
- Token addresses (`tokens`, list, required): The contract addresses to price, up to 30 of them, all on the chain above. Separate them with spaces, commas or new lines. A dexscreener.com link works in place of an address.

**Outputs**

- `chain` (text): That chain's name.
- `chain_id` (text): The chain these tokens are on.
- `count` (number): How many tokens came back.
- `not_found` (list): Tokens DEX Screener has no pools for, exactly as they were given. Empty when every one was found.
- `note` (text): Set only when something needs saying -- results trimmed, a chain with nothing on it, a token with no price. Empty otherwise.
- `priced_count` (number): How many of those have a price. A token found only as the quote side of a pool has none.
- `tokens` (list): The tokens, deepest liquidity first.
- `top_token` (object): The one with the most liquidity.
- `unpriced` (list): Tokens that were found but have no price, because they only ever sit on the quote side of a pool.

**Example output**

```json
{
  "chain": "Solana",
  "chain_id": "solana",
  "count": 1,
  "not_found": [],
  "note": null,
  "priced_count": 1,
  "tokens": [
    {
      "chain": "Solana",
      "chain_id": "solana",
      "dexscreener_url": "https://dexscreener.com/solana/So11111111111111111111111111111111111111112",
      "fdv": 110400000000.0,
      "image_url": "https://dd.dexscreener.com/ds-data/tokens/solana/So11111111111111111111111111111111111111112.png",
      "liquidity_usd": 24310000.0,
      "market_cap": 98700000000.0,
      "name": "Wrapped SOL",
      "pool_count": 7,
      "price_change_24h_percent": 3.47,
      "price_usd": 184.21,
      "priced_pool_count": 5,
      "socials": [
        {
          "handle": "solana",
          "label": "Twitter",
          "url": "https://x.com/solana"
        }
      ],
      "symbol": "SOL",
      "token_address": "So11111111111111111111111111111111111111112",
      "top_pool": {
        "active_boosts": null,
        "age_days": 2011.3,
        "base_token_address": "So11111111111111111111111111111111111111112",
        "base_token_name": "Wrapped SOL",
        "base_token_symbol": "SOL",
        "buy_sell_ratio_24h": 1.0502,
        "buys_24h": 48213,
        "chain": "Solana",
        "chain_id": "solana",
        "created_at": "2021-03-12T18:04:11Z",
        "dex": "raydium",
        "dexscreener_url": "https://dexscreener.com/solana/58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
        "fdv": 110400000000.0,
        "image_url": "https://dd.dexscreener.com/ds-data/tokens/solana/So11111111111111111111111111111111111111112.png",
        "labels": [],
        "liquidity_base": 22860.0,
        "liquidity_quote": 4210000.0,
        "liquidity_usd": 8420000.0,
        "market_cap": 98700000000.0,
        "pair": "SOL/USDC",
        "pair_address": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
        "price_change_1h_percent": -0.31,
        "price_change_24h_percent": 3.47,
        "price_change_5m_percent": 0.04,
        "price_change_6h_percent": 1.12,
        "price_native": 184.21,
        "price_usd": 184.21,
        "quote_token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "quote_token_name": "USD Coin",
        "quote_token_symbol": "USDC",
        "sells_24h": 45907,
        "socials": [
          {
            "handle": "solana",
            "label": "Twitter",
            "url": "https://x.com/solana"
          }
        ],
        "txns_24h": 94120,
        "volume_1h_usd": 2841000.0,
        "volume_24h_usd": 61840000.0,
        "volume_5m_usd": 214500.0,
        "volume_6h_usd": 15230000.0,
        "websites": [
          {
            "label": "solana.com",
            "url": "https://solana.com"
          }
        ]
      },
      "txns_24h": 271400,
      "volume_24h_usd": 184200000.0,
      "websites": [
        {
          "label": "solana.com",
          "url": "https://solana.com"
        }
      ]
    }
  ],
  "top_token": {
    "chain": "Solana",
    "chain_id": "solana",
    "dexscreener_url": "https://dexscreener.com/solana/So11111111111111111111111111111111111111112",
    "fdv": 110400000000.0,
    "image_url": "https://dd.dexscreener.com/ds-data/tokens/solana/So11111111111111111111111111111111111111112.png",
    "liquidity_usd": 24310000.0,
    "market_cap": 98700000000.0,
    "name": "Wrapped SOL",
    "pool_count": 7,
    "price_change_24h_percent": 3.47,
    "price_usd": 184.21,
    "priced_pool_count": 5,
    "socials": [
      {
        "handle": "solana",
        "label": "Twitter",
        "url": "https://x.com/solana"
      }
    ],
    "symbol": "SOL",
    "token_address": "So11111111111111111111111111111111111111112",
    "top_pool": {
      "active_boosts": null,
      "age_days": 2011.3,
      "base_token_address": "So11111111111111111111111111111111111111112",
      "base_token_name": "Wrapped SOL",
      "base_token_symbol": "SOL",
      "buy_sell_ratio_24h": 1.0502,
      "buys_24h": 48213,
      "chain": "Solana",
      "chain_id": "solana",
      "created_at": "2021-03-12T18:04:11Z",
      "dex": "raydium",
      "dexscreener_url": "https://dexscreener.com/solana/58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
      "fdv": 110400000000.0,
      "image_url": "https://dd.dexscreener.com/ds-data/tokens/solana/So11111111111111111111111111111111111111112.png",
      "labels": [],
      "liquidity_base": 22860.0,
      "liquidity_quote": 4210000.0,
      "liquidity_usd": 8420000.0,
      "market_cap": 98700000000.0,
      "pair": "SOL/USDC",
      "pair_address": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
      "price_change_1h_percent": -0.31,
      "price_change_24h_percent": 3.47,
      "price_change_5m_percent": 0.04,
      "price_change_6h_percent": 1.12,
      "price_native": 184.21,
      "price_usd": 184.21,
      "quote_token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "quote_token_name": "USD Coin",
      "quote_token_symbol": "USDC",
      "sells_24h": 45907,
      "socials": [
        {
          "handle": "solana",
          "label": "Twitter",
          "url": "https://x.com/solana"
        }
      ],
      "txns_24h": 94120,
      "volume_1h_usd": 2841000.0,
      "volume_24h_usd": 61840000.0,
      "volume_5m_usd": 214500.0,
      "volume_6h_usd": 15230000.0,
      "websites": [
        {
          "label": "solana.com",
          "url": "https://solana.com"
        }
      ]
    },
    "txns_24h": 271400,
    "volume_24h_usd": 184200000.0,
    "websites": [
      {
        "label": "solana.com",
        "url": "https://solana.com"
      }
    ]
  },
  "unpriced": []
}
```

### List a token's pools

Find every pool one token trades in, deepest first, with each pool's exchange, price, liquidity, volume and age. Each pool says whether the token is its base or its quote side, because DEX Screener only ever reports the base token's price, so a token found only as a quote has no price of its own here, and says so.

**Inputs**

- Chain (`chain`, text, required): Which blockchain the token is on. Pick it from the list, or type the chain id DEX Screener uses for any other chain: it is the first part of the address in every dexscreener.com link.
- Token (`token`, text, required): The token's contract address, or its dexscreener.com link: a link carries the chain too, so pasting one is enough on its own. Every step here returns a link, so one step can hand a token to the next.
- How many pools (`limit`, number): How many pools to return, deepest first. From 1 to 100. Default: `30`.

**Outputs**

- `chain` (text): That chain's name.
- `chain_id` (text): The chain the token is on.
- `count` (number): How many pools are listed here.
- `dex_count` (number): How many exchanges they are spread over.
- `dexscreener_url` (text): The token's page.
- `name` (text): Its name.
- `note` (text): Set only when something needs saying -- results trimmed, a chain with nothing on it, a token with no price. Empty otherwise.
- `pools` (list): The pools, deepest first.
- `price_usd` (number): Its price, from its deepest pool.
- `symbol` (text): Its ticker symbol.
- `token_address` (text): The token's contract address.
- `top_pool` (object): Its deepest pool. Carries ``side`` like the rest.
- `total_liquidity_usd` (number): Everything its pools hold, added up over the pools it is the base token of.
- `total_pools` (number): How many there are in all.
- `total_volume_24h_usd` (number): Dollars traded across those pools in 24 hours.

**Example output**

```json
{
  "chain": "Solana",
  "chain_id": "solana",
  "count": 1,
  "dex_count": 4,
  "dexscreener_url": "https://dexscreener.com/solana/So11111111111111111111111111111111111111112",
  "name": "Wrapped SOL",
  "note": null,
  "pools": [
    {
      "active_boosts": null,
      "age_days": 2011.3,
      "base_token_address": "So11111111111111111111111111111111111111112",
      "base_token_name": "Wrapped SOL",
      "base_token_symbol": "SOL",
      "buy_sell_ratio_24h": 1.0502,
      "buys_24h": 48213,
      "chain": "Solana",
      "chain_id": "solana",
      "created_at": "2021-03-12T18:04:11Z",
      "dex": "raydium",
      "dexscreener_url": "https://dexscreener.com/solana/58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
      "fdv": 110400000000.0,
      "image_url": "https://dd.dexscreener.com/ds-data/tokens/solana/So11111111111111111111111111111111111111112.png",
      "labels": [],
      "liquidity_base": 22860.0,
      "liquidity_quote": 4210000.0,
      "liquidity_usd": 8420000.0,
      "market_cap": 98700000000.0,
      "pair": "SOL/USDC",
      "pair_address": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
      "price_change_1h_percent": -0.31,
      "price_change_24h_percent": 3.47,
      "price_change_5m_percent": 0.04,
      "price_change_6h_percent": 1.12,
      "price_native": 184.21,
      "price_usd": 184.21,
      "quote_token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "quote_token_name": "USD Coin",
      "quote_token_symbol": "USDC",
      "sells_24h": 45907,
      "side": "base",
      "socials": [
        {
          "handle": "solana",
          "label": "Twitter",
          "url": "https://x.com/solana"
        }
      ],
      "txns_24h": 94120,
      "volume_1h_usd": 2841000.0,
      "volume_24h_usd": 61840000.0,
      "volume_5m_usd": 214500.0,
      "volume_6h_usd": 15230000.0,
      "websites": [
        {
          "label": "solana.com",
          "url": "https://solana.com"
        }
      ]
    }
  ],
  "price_usd": 184.21,
  "symbol": "SOL",
  "token_address": "So11111111111111111111111111111111111111112",
  "top_pool": {
    "active_boosts": null,
    "age_days": 2011.3,
    "base_token_address": "So11111111111111111111111111111111111111112",
    "base_token_name": "Wrapped SOL",
    "base_token_symbol": "SOL",
    "buy_sell_ratio_24h": 1.0502,
    "buys_24h": 48213,
    "chain": "Solana",
    "chain_id": "solana",
    "created_at": "2021-03-12T18:04:11Z",
    "dex": "raydium",
    "dexscreener_url": "https://dexscreener.com/solana/58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
    "fdv": 110400000000.0,
    "image_url": "https://dd.dexscreener.com/ds-data/tokens/solana/So11111111111111111111111111111111111111112.png",
    "labels": [],
    "liquidity_base": 22860.0,
    "liquidity_quote": 4210000.0,
    "liquidity_usd": 8420000.0,
    "market_cap": 98700000000.0,
    "pair": "SOL/USDC",
    "pair_address": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
    "price_change_1h_percent": -0.31,
    "price_change_24h_percent": 3.47,
    "price_change_5m_percent": 0.04,
    "price_change_6h_percent": 1.12,
    "price_native": 184.21,
    "price_usd": 184.21,
    "quote_token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "quote_token_name": "USD Coin",
    "quote_token_symbol": "USDC",
    "sells_24h": 45907,
    "side": "base",
    "socials": [
      {
        "handle": "solana",
        "label": "Twitter",
        "url": "https://x.com/solana"
      }
    ],
    "txns_24h": 94120,
    "volume_1h_usd": 2841000.0,
    "volume_24h_usd": 61840000.0,
    "volume_5m_usd": 214500.0,
    "volume_6h_usd": 15230000.0,
    "websites": [
      {
        "label": "solana.com",
        "url": "https://solana.com"
      }
    ]
  },
  "total_liquidity_usd": 24310000.0,
  "total_pools": 7,
  "total_volume_24h_usd": 184200000.0
}
```

### List boosted tokens

See which tokens are paying DEX Screener to be seen: either the boosts bought most recently or the tokens with the most boosts of all time. Both the boost just bought and the running total come back, because they are different numbers and the total is the one that says how hard a token is being promoted.

**Inputs**

- Which boosts (`feed`, text): Whether to see the boosts just bought or the tokens with the most of them. One of: `latest` (Newest boosts), `top` (Most boosted tokens). Default: `latest`.
- Chain (`chain`, text): Only keep results on one blockchain. Leave it empty for every chain at once, which is how these feeds arrive.
- How many tokens (`limit`, number): How many boosted tokens to return. From 1 to 100. Default: `30`.

**Outputs**

- `chain` (text): That chain's name.
- `chain_id` (text): The chain results were narrowed to, if any.
- `count` (number): How many are listed here.
- `feed` (text): Which feed was read.
- `note` (text): Set only when something needs saying -- results trimmed, a chain with nothing on it, a token with no price. Empty otherwise.
- `tokens` (list): The boosted tokens.
- `top_token` (object): The first of them.
- `total_boost` (number): Their boost totals added together.

**Example output**

```json
{
  "chain": null,
  "chain_id": null,
  "count": 1,
  "feed": "top",
  "note": null,
  "tokens": [
    {
      "chain": "Solana",
      "chain_id": "solana",
      "description": "A community-run token on Solana, with the team's links published through DEX Screener's token profile.",
      "dexscreener_url": "https://dexscreener.com/solana/6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
      "header_image_url": "https://dd.dexscreener.com/ds-data/tokens/solana/example/header.png",
      "icon_url": "https://dd.dexscreener.com/ds-data/tokens/solana/example.png",
      "latest_boost": 500.0,
      "link_count": 3,
      "links": [
        {
          "label": "Website",
          "type": "website",
          "url": "https://example.org"
        },
        {
          "label": "Twitter",
          "type": "twitter",
          "url": "https://x.com/example"
        },
        {
          "label": "Telegram",
          "type": "telegram",
          "url": "https://t.me/example"
        }
      ],
      "telegram_url": "https://t.me/example",
      "token_address": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
      "total_boost": 12500.0,
      "twitter_url": "https://x.com/example",
      "website": "https://example.org"
    }
  ],
  "top_token": {
    "chain": "Solana",
    "chain_id": "solana",
    "description": "A community-run token on Solana, with the team's links published through DEX Screener's token profile.",
    "dexscreener_url": "https://dexscreener.com/solana/6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
    "header_image_url": "https://dd.dexscreener.com/ds-data/tokens/solana/example/header.png",
    "icon_url": "https://dd.dexscreener.com/ds-data/tokens/solana/example.png",
    "latest_boost": 500.0,
    "link_count": 3,
    "links": [
      {
        "label": "Website",
        "type": "website",
        "url": "https://example.org"
      },
      {
        "label": "Twitter",
        "type": "twitter",
        "url": "https://x.com/example"
      },
      {
        "label": "Telegram",
        "type": "telegram",
        "url": "https://t.me/example"
      }
    ],
    "telegram_url": "https://t.me/example",
    "token_address": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
    "total_boost": 12500.0,
    "twitter_url": "https://x.com/example",
    "website": "https://example.org"
  },
  "total_boost": 12500.0
}
```

### List community takeovers

See the tokens a community has taken over from the team that launched them, newest claim first, each with the description and links the new owners published and the day they claimed it.

**Inputs**

- Chain (`chain`, text): Only keep results on one blockchain. Leave it empty for every chain at once, which is how these feeds arrive.
- How many tokens (`limit`, number): How many takeovers to return. From 1 to 100. Default: `30`.

**Outputs**

- `chain` (text): That chain's name.
- `chain_id` (text): The chain results were narrowed to, if any.
- `chains` (list): Every chain represented here.
- `count` (number): How many are listed here.
- `newest` (object): The most recent of them.
- `note` (text): Set only when something needs saying -- results trimmed, a chain with nothing on it, a token with no price. Empty otherwise.
- `takeovers` (list): The takeovers, newest first.

**Example output**

```json
{
  "chain": null,
  "chain_id": null,
  "chains": [
    "solana"
  ],
  "count": 1,
  "newest": {
    "chain": "Solana",
    "chain_id": "solana",
    "claimed_at": "2026-09-11T14:22:05Z",
    "description": "A community-run token on Solana, with the team's links published through DEX Screener's token profile.",
    "dexscreener_url": "https://dexscreener.com/solana/6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
    "header_image_url": "https://dd.dexscreener.com/ds-data/tokens/solana/example/header.png",
    "icon_url": "https://dd.dexscreener.com/ds-data/tokens/solana/example.png",
    "link_count": 3,
    "links": [
      {
        "label": "Website",
        "type": "website",
        "url": "https://example.org"
      },
      {
        "label": "Twitter",
        "type": "twitter",
        "url": "https://x.com/example"
      },
      {
        "label": "Telegram",
        "type": "telegram",
        "url": "https://t.me/example"
      }
    ],
    "telegram_url": "https://t.me/example",
    "token_address": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
    "twitter_url": "https://x.com/example",
    "website": "https://example.org"
  },
  "note": null,
  "takeovers": [
    {
      "chain": "Solana",
      "chain_id": "solana",
      "claimed_at": "2026-09-11T14:22:05Z",
      "description": "A community-run token on Solana, with the team's links published through DEX Screener's token profile.",
      "dexscreener_url": "https://dexscreener.com/solana/6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
      "header_image_url": "https://dd.dexscreener.com/ds-data/tokens/solana/example/header.png",
      "icon_url": "https://dd.dexscreener.com/ds-data/tokens/solana/example.png",
      "link_count": 3,
      "links": [
        {
          "label": "Website",
          "type": "website",
          "url": "https://example.org"
        },
        {
          "label": "Twitter",
          "type": "twitter",
          "url": "https://x.com/example"
        },
        {
          "label": "Telegram",
          "type": "telegram",
          "url": "https://t.me/example"
        }
      ],
      "telegram_url": "https://t.me/example",
      "token_address": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
      "twitter_url": "https://x.com/example",
      "website": "https://example.org"
    }
  ]
}
```

### List new token profiles

See the tokens whose teams have just published a profile on DEX Screener: the description, logo, banner and links they want people to see. Choose the newest profiles or the ones just edited, and narrow to one chain. The website, X account and Telegram are pulled out of the link list for you.

**Inputs**

- Which profiles (`feed`, text): Whether to see brand-new profiles or freshly edited ones. One of: `latest` (Newest profiles), `recently_updated` (Recently updated profiles). Default: `latest`.
- Chain (`chain`, text): Only keep results on one blockchain. Leave it empty for every chain at once, which is how these feeds arrive.
- How many tokens (`limit`, number): How many profiles to return. From 1 to 100. Default: `30`.

**Outputs**

- `chain` (text): That chain's name.
- `chain_id` (text): The chain results were narrowed to, if any.
- `chains` (list): Every chain represented here.
- `count` (number): How many are listed here.
- `feed` (text): Which feed was read.
- `newest` (object): The most recent of them.
- `note` (text): Set only when something needs saying -- results trimmed, a chain with nothing on it, a token with no price. Empty otherwise.
- `profiles` (list): The profiles, newest first.

**Example output**

```json
{
  "chain": null,
  "chain_id": null,
  "chains": [
    "solana"
  ],
  "count": 1,
  "feed": "latest",
  "newest": {
    "chain": "Solana",
    "chain_id": "solana",
    "description": "A community-run token on Solana, with the team's links published through DEX Screener's token profile.",
    "dexscreener_url": "https://dexscreener.com/solana/6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
    "header_image_url": "https://dd.dexscreener.com/ds-data/tokens/solana/example/header.png",
    "icon_url": "https://dd.dexscreener.com/ds-data/tokens/solana/example.png",
    "link_count": 3,
    "links": [
      {
        "label": "Website",
        "type": "website",
        "url": "https://example.org"
      },
      {
        "label": "Twitter",
        "type": "twitter",
        "url": "https://x.com/example"
      },
      {
        "label": "Telegram",
        "type": "telegram",
        "url": "https://t.me/example"
      }
    ],
    "telegram_url": "https://t.me/example",
    "token_address": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
    "twitter_url": "https://x.com/example",
    "website": "https://example.org"
  },
  "note": null,
  "profiles": [
    {
      "chain": "Solana",
      "chain_id": "solana",
      "description": "A community-run token on Solana, with the team's links published through DEX Screener's token profile.",
      "dexscreener_url": "https://dexscreener.com/solana/6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
      "header_image_url": "https://dd.dexscreener.com/ds-data/tokens/solana/example/header.png",
      "icon_url": "https://dd.dexscreener.com/ds-data/tokens/solana/example.png",
      "link_count": 3,
      "links": [
        {
          "label": "Website",
          "type": "website",
          "url": "https://example.org"
        },
        {
          "label": "Twitter",
          "type": "twitter",
          "url": "https://x.com/example"
        },
        {
          "label": "Telegram",
          "type": "telegram",
          "url": "https://t.me/example"
        }
      ],
      "telegram_url": "https://t.me/example",
      "token_address": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
      "twitter_url": "https://x.com/example",
      "website": "https://example.org"
    }
  ]
}
```

### List token ads

See which tokens are advertising on DEX Screener right now, what kind of placement each one bought, how long it runs for and how many times it has been shown.

**Inputs**

- Chain (`chain`, text): Only keep results on one blockchain. Leave it empty for every chain at once, which is how these feeds arrive.
- How many ads (`limit`, number): How many ads to return. From 1 to 100. Default: `30`.

**Outputs**

- `ad_types` (list): Every kind of ad represented here.
- `ads` (list): The ads, newest first.
- `chain` (text): That chain's name.
- `chain_id` (text): The chain results were narrowed to, if any.
- `count` (number): How many are listed here.
- `newest` (object): The most recent of them.
- `note` (text): Set only when something needs saying -- results trimmed, a chain with nothing on it, a token with no price. Empty otherwise.
- `total_impressions` (number): How many times they have been shown, added up.

**Example output**

```json
{
  "ad_types": [
    "trendingBarAd"
  ],
  "ads": [
    {
      "ad_type": "trendingBarAd",
      "chain": "Solana",
      "chain_id": "solana",
      "dexscreener_url": "https://dexscreener.com/solana/6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
      "duration_hours": 24.0,
      "impressions": 412800,
      "started_at": "2026-09-13T09:00:00Z",
      "token_address": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"
    }
  ],
  "chain": null,
  "chain_id": null,
  "count": 1,
  "newest": {
    "ad_type": "trendingBarAd",
    "chain": "Solana",
    "chain_id": "solana",
    "dexscreener_url": "https://dexscreener.com/solana/6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
    "duration_hours": 24.0,
    "impressions": 412800,
    "started_at": "2026-09-13T09:00:00Z",
    "token_address": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"
  },
  "note": null,
  "total_impressions": 412800
}
```

### List trending metas

See which narratives money is moving into right now: the themes DEX Screener groups tokens under, each with what its tokens are worth together, how that has moved over five minutes, an hour, six hours and a day, and how many tokens are in it. Each one comes back with the slug 'Get a meta' takes.

**Inputs**

- How many metas (`limit`, number): How many metas to return, in DEX Screener's trending order. From 1 to 100. Default: `30`.

**Outputs**

- `count` (number): How many are listed here.
- `metas` (list): The metas, most trending first.
- `note` (text): Set only when something needs saying -- results trimmed, a chain with nothing on it, a token with no price. Empty otherwise.
- `top_meta` (object): The most trending of them.
- `total_market_cap_usd` (number): What the listed metas are worth together.
- `total_metas` (number): How many are trending in all.

**Example output**

```json
{
  "count": 1,
  "metas": [
    {
      "description": "Tokens for autonomous agents that trade, post and build.",
      "dexscreener_url": "https://dexscreener.com/metas/ai-agents",
      "icon_type": "emoji",
      "icon_value": "\ud83e\udd16",
      "liquidity_usd": 184000000.0,
      "market_cap_change_1h_percent": -0.84,
      "market_cap_change_24h_percent": 7.63,
      "market_cap_change_5m_percent": 0.12,
      "market_cap_change_6h_percent": 2.41,
      "market_cap_delta_1h_usd": -40700000.0,
      "market_cap_delta_24h_usd": 341900000.0,
      "market_cap_delta_5m_usd": 5800000.0,
      "market_cap_delta_6h_usd": 113400000.0,
      "market_cap_usd": 4820000000.0,
      "name": "AI Agents",
      "slug": "ai-agents",
      "token_count": 312,
      "volume_usd": 921000000.0
    }
  ],
  "note": null,
  "top_meta": {
    "description": "Tokens for autonomous agents that trade, post and build.",
    "dexscreener_url": "https://dexscreener.com/metas/ai-agents",
    "icon_type": "emoji",
    "icon_value": "\ud83e\udd16",
    "liquidity_usd": 184000000.0,
    "market_cap_change_1h_percent": -0.84,
    "market_cap_change_24h_percent": 7.63,
    "market_cap_change_5m_percent": 0.12,
    "market_cap_change_6h_percent": 2.41,
    "market_cap_delta_1h_usd": -40700000.0,
    "market_cap_delta_24h_usd": 341900000.0,
    "market_cap_delta_5m_usd": 5800000.0,
    "market_cap_delta_6h_usd": 113400000.0,
    "market_cap_usd": 4820000000.0,
    "name": "AI Agents",
    "slug": "ai-agents",
    "token_count": 312,
    "volume_usd": 921000000.0
  },
  "total_market_cap_usd": 4820000000.0,
  "total_metas": 24
}
```

### Search for pools

Find where a token trades by searching for its name, its symbol, a pair like SOL/USDC, or a contract address. Results come back deepest pool first rather than in DEX Screener's own relevance order, so the real token outranks the copies trading on a few dollars, and can be narrowed to one chain. Start here when all you have is a name.

**Inputs**

- Search (`query`, text, required): What to look for: a token name, a ticker symbol, a pair like SOL/USDC, or a contract address.
- Chain (`chain`, text): Only keep results on one blockchain. Leave it empty for every chain at once, which is how these feeds arrive.
- How many pools (`limit`, number): How many pools to return, deepest first. From 1 to 100. Default: `30`.

**Outputs**

- `chain` (text): That chain's name.
- `chain_id` (text): The chain results were narrowed to, if any.
- `chains` (list): Every chain the search found something on. Useful when you do not know where a token lives.
- `count` (number): How many pools are listed here.
- `note` (text): Set only when something needs saying -- results trimmed, a chain with nothing on it, a token with no price. Empty otherwise.
- `pairs` (list): The pools, deepest first.
- `query` (text): What was searched for.
- `top_pair` (object): The deepest pool of these.
- `total_matches` (number): How many DEX Screener matched in all, before the chain filter and the limit.

**Example output**

```json
{
  "chain": "Solana",
  "chain_id": "solana",
  "chains": [
    "ethereum",
    "solana"
  ],
  "count": 1,
  "note": null,
  "pairs": [
    {
      "active_boosts": null,
      "age_days": 2011.3,
      "base_token_address": "So11111111111111111111111111111111111111112",
      "base_token_name": "Wrapped SOL",
      "base_token_symbol": "SOL",
      "buy_sell_ratio_24h": 1.0502,
      "buys_24h": 48213,
      "chain": "Solana",
      "chain_id": "solana",
      "created_at": "2021-03-12T18:04:11Z",
      "dex": "raydium",
      "dexscreener_url": "https://dexscreener.com/solana/58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
      "fdv": 110400000000.0,
      "image_url": "https://dd.dexscreener.com/ds-data/tokens/solana/So11111111111111111111111111111111111111112.png",
      "labels": [],
      "liquidity_base": 22860.0,
      "liquidity_quote": 4210000.0,
      "liquidity_usd": 8420000.0,
      "market_cap": 98700000000.0,
      "pair": "SOL/USDC",
      "pair_address": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
      "price_change_1h_percent": -0.31,
      "price_change_24h_percent": 3.47,
      "price_change_5m_percent": 0.04,
      "price_change_6h_percent": 1.12,
      "price_native": 184.21,
      "price_usd": 184.21,
      "quote_token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "quote_token_name": "USD Coin",
      "quote_token_symbol": "USDC",
      "sells_24h": 45907,
      "socials": [
        {
          "handle": "solana",
          "label": "Twitter",
          "url": "https://x.com/solana"
        }
      ],
      "txns_24h": 94120,
      "volume_1h_usd": 2841000.0,
      "volume_24h_usd": 61840000.0,
      "volume_5m_usd": 214500.0,
      "volume_6h_usd": 15230000.0,
      "websites": [
        {
          "label": "solana.com",
          "url": "https://solana.com"
        }
      ]
    }
  ],
  "query": "SOL/USDC",
  "top_pair": {
    "active_boosts": null,
    "age_days": 2011.3,
    "base_token_address": "So11111111111111111111111111111111111111112",
    "base_token_name": "Wrapped SOL",
    "base_token_symbol": "SOL",
    "buy_sell_ratio_24h": 1.0502,
    "buys_24h": 48213,
    "chain": "Solana",
    "chain_id": "solana",
    "created_at": "2021-03-12T18:04:11Z",
    "dex": "raydium",
    "dexscreener_url": "https://dexscreener.com/solana/58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
    "fdv": 110400000000.0,
    "image_url": "https://dd.dexscreener.com/ds-data/tokens/solana/So11111111111111111111111111111111111111112.png",
    "labels": [],
    "liquidity_base": 22860.0,
    "liquidity_quote": 4210000.0,
    "liquidity_usd": 8420000.0,
    "market_cap": 98700000000.0,
    "pair": "SOL/USDC",
    "pair_address": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
    "price_change_1h_percent": -0.31,
    "price_change_24h_percent": 3.47,
    "price_change_5m_percent": 0.04,
    "price_change_6h_percent": 1.12,
    "price_native": 184.21,
    "price_usd": 184.21,
    "quote_token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "quote_token_name": "USD Coin",
    "quote_token_symbol": "USDC",
    "sells_24h": 45907,
    "socials": [
      {
        "handle": "solana",
        "label": "Twitter",
        "url": "https://x.com/solana"
      }
    ],
    "txns_24h": 94120,
    "volume_1h_usd": 2841000.0,
    "volume_24h_usd": 61840000.0,
    "volume_5m_usd": 214500.0,
    "volume_6h_usd": 15230000.0,
    "websites": [
      {
        "label": "solana.com",
        "url": "https://solana.com"
      }
    ]
  },
  "total_matches": 28
}
```
