# Table of Contents

- [Reference | DEX Screener - Docs](#reference-dex-screener-docs)
- [WebSockets | DEX Screener - Docs](#websockets-dex-screener-docs)
- [API Terms & Conditions | DEX Screener - Docs](#api-terms-conditions-dex-screener-docs)
- [Unknown](#unknown)
- [Unknown](#unknown)
- [Unknown](#unknown)
- [Reference | DEX Screener - Docs](#reference-dex-screener-docs)

---

# Reference | DEX Screener - Docs

For the complete documentation index, see [llms.txt](https://docs.dexscreener.com/llms.txt)
. This page is also available as [Markdown](https://docs.dexscreener.com/api/reference.md)
.

Copy

On this page

### Get the latest token profiles (rate-limit 60 requests per minute)[](https://docs.dexscreener.com/api/reference#get-token-profiles-latest-v1)

gethttps://api.dexscreener.com/token-profiles/latest/v1

Responses

200

Ok

application/json

urlstring · uriOptional

chainIdstringOptional

tokenAddressstringOptional

iconstring · uriOptional

headerstring · uri · nullableOptional

descriptionstring · nullableOptional

linksobject\[\] · nullableOptional

Show properties

get/token-profiles/latest/v1

HTTP

Copy

    GET /token-profiles/latest/v1 HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    {
      "url": "https://example.com",
      "chainId": "text",
      "tokenAddress": "text",
      "icon": "https://example.com",
      "header": "https://example.com",
      "description": "text",
      "links": [\
        {\
          "type": "text",\
          "label": "text",\
          "url": "https://example.com"\
        }\
      ]
    }

### Get recently updated token profiles (rate-limit 60 requests per minute)[](https://docs.dexscreener.com/api/reference#get-token-profiles-recent-updates-v1)

gethttps://api.dexscreener.com/token-profiles/recent-updates/v1

Responses

200

Ok

application/json

urlstring · uriOptional

chainIdstringOptional

tokenAddressstringOptional

iconstring · uriOptional

headerstring · uri · nullableOptional

descriptionstring · nullableOptional

linksobject\[\] · nullableOptional

Show properties

get/token-profiles/recent-updates/v1

HTTP

Copy

    GET /token-profiles/recent-updates/v1 HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    {
      "url": "https://example.com",
      "chainId": "text",
      "tokenAddress": "text",
      "icon": "https://example.com",
      "header": "https://example.com",
      "description": "text",
      "links": [\
        {\
          "type": "text",\
          "label": "text",\
          "url": "https://example.com"\
        }\
      ]
    }

### Get the latest token community takeovers (rate-limit 60 requests per minute)[](https://docs.dexscreener.com/api/reference#get-community-takeovers-latest-v1)

gethttps://api.dexscreener.com/community-takeovers/latest/v1

Responses

200

Ok

application/json

urlstring · uriOptional

chainIdstringOptional

tokenAddressstringOptional

iconstring · uriOptional

headerstring · uri · nullableOptional

descriptionstring · nullableOptional

linksobject\[\] · nullableOptional

Show properties

claimDatestring · date-timeOptional

get/community-takeovers/latest/v1

HTTP

Copy

    GET /community-takeovers/latest/v1 HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    [\
      {\
        "url": "https://example.com",\
        "chainId": "text",\
        "tokenAddress": "text",\
        "icon": "https://example.com",\
        "header": "https://example.com",\
        "description": "text",\
        "links": [\
          {\
            "type": "text",\
            "label": "text",\
            "url": "https://example.com"\
          }\
        ],\
        "claimDate": "2026-01-01T00:00:00.000Z"\
      }\
    ]

### Get the latest ads (rate-limit 60 requests per minute)[](https://docs.dexscreener.com/api/reference#get-a-ds-latest-v1)

gethttps://api.dexscreener.com/ads/latest/v1

Responses

200

Ok

application/json

urlstring · uriOptional

chainIdstringOptional

tokenAddressstringOptional

datestring · date-timeOptional

typestringOptional

durationHoursnumber · nullableOptional

impressionsnumber · nullableOptional

get/ads/latest/v1

HTTP

Copy

    GET /ads/latest/v1 HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    [\
      {\
        "url": "https://example.com",\
        "chainId": "text",\
        "tokenAddress": "text",\
        "date": "2026-01-01T00:00:00.000Z",\
        "type": "text",\
        "durationHours": 1,\
        "impressions": 1\
      }\
    ]

### Get the latest boosted tokens (rate-limit 60 requests per minute)[](https://docs.dexscreener.com/api/reference#get-token-boosts-latest-v1)

gethttps://api.dexscreener.com/token-boosts/latest/v1

Responses

200

Ok

application/json

urlstring · uriOptional

chainIdstringOptional

tokenAddressstringOptional

amountnumberOptional

totalAmountnumberOptional

iconstring · uri · nullableOptional

headerstring · uri · nullableOptional

descriptionstring · nullableOptional

linksobject\[\] · nullableOptional

Show properties

get/token-boosts/latest/v1

HTTP

Copy

    GET /token-boosts/latest/v1 HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    {
      "url": "https://example.com",
      "chainId": "text",
      "tokenAddress": "text",
      "amount": 1,
      "totalAmount": 1,
      "icon": "https://example.com",
      "header": "https://example.com",
      "description": "text",
      "links": [\
        {\
          "type": "text",\
          "label": "text",\
          "url": "https://example.com"\
        }\
      ]
    }

### Get the tokens with most active boosts (rate-limit 60 requests per minute)[](https://docs.dexscreener.com/api/reference#get-token-boosts-top-v1)

gethttps://api.dexscreener.com/token-boosts/top/v1

Responses

200

Ok

application/json

urlstring · uriOptional

chainIdstringOptional

tokenAddressstringOptional

amountnumberOptional

totalAmountnumberOptional

iconstring · uri · nullableOptional

headerstring · uri · nullableOptional

descriptionstring · nullableOptional

linksobject\[\] · nullableOptional

Show properties

get/token-boosts/top/v1

HTTP

Copy

    GET /token-boosts/top/v1 HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    {
      "url": "https://example.com",
      "chainId": "text",
      "tokenAddress": "text",
      "amount": 1,
      "totalAmount": 1,
      "icon": "https://example.com",
      "header": "https://example.com",
      "description": "text",
      "links": [\
        {\
          "type": "text",\
          "label": "text",\
          "url": "https://example.com"\
        }\
      ]
    }

### Check paid orders for a token (rate-limit 60 requests per minute)[](https://docs.dexscreener.com/api/reference#get-orders-v1-chainid-tokenaddress)

gethttps://api.dexscreener.com/orders/v1/{chainId}/{tokenAddress}

Path parameters

chainIdstringRequiredExample: `solana`

tokenAddressstringRequiredExample: `A55XjvzRU4KtR3Lrys8PpLZQvPojPqvnv5bJVHMYy3Jv`

Responses

200

Ok

application/json

typestring · enumOptionalPossible values: `tokenProfile``communityTakeover``tokenAd``trendingBarAd`

statusstring · enumOptionalPossible values: `processing``cancelled``on-hold``approved``rejected`

paymentTimestampnumberOptional

get/orders/v1/{chainId}/{tokenAddress}

HTTP

Copy

    GET /orders/v1/{chainId}/{tokenAddress} HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    [\
      {\
        "type": "tokenProfile",\
        "status": "processing",\
        "paymentTimestamp": 1\
      }\
    ]

### Get one or multiple pairs by chain and pair address (rate-limit 300 requests per minute)[](https://docs.dexscreener.com/api/reference#get-latest-dex-pairs-chainid-pairid)

gethttps://api.dexscreener.com/latest/dex/pairs/{chainId}/{pairId}

Path parameters

chainIdstringRequiredExample: `solana`

pairIdstringRequiredExample: `JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN`

Responses

200

Ok

application/json

schemaVersionstringOptional

pairsobject · Pair\[\] · nullableOptional

Show properties

get/latest/dex/pairs/{chainId}/{pairId}

HTTP

Copy

    GET /latest/dex/pairs/{chainId}/{pairId} HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    {
      "schemaVersion": "text",
      "pairs": [\
        {\
          "chainId": "text",\
          "dexId": "text",\
          "url": "https://example.com",\
          "pairAddress": "text",\
          "labels": [\
            "text"\
          ],\
          "baseToken": {\
            "address": "text",\
            "name": "text",\
            "symbol": "text"\
          },\
          "quoteToken": {\
            "address": "text",\
            "name": "text",\
            "symbol": "text"\
          },\
          "priceNative": "text",\
          "priceUsd": "text",\
          "txns": {\
            "ANY_ADDITIONAL_PROPERTY": {\
              "buys": 1,\
              "sells": 1\
            }\
          },\
          "volume": {\
            "ANY_ADDITIONAL_PROPERTY": 1\
          },\
          "priceChange": {\
            "ANY_ADDITIONAL_PROPERTY": 1\
          },\
          "liquidity": {\
            "usd": 1,\
            "base": 1,\
            "quote": 1\
          },\
          "fdv": 1,\
          "marketCap": 1,\
          "pairCreatedAt": 1,\
          "info": {\
            "imageUrl": "https://example.com",\
            "websites": [\
              {\
                "url": "https://example.com"\
              }\
            ],\
            "socials": [\
              {\
                "platform": "text",\
                "handle": "text"\
              }\
            ]\
          },\
          "boosts": {\
            "active": 1\
          }\
        }\
      ]
    }

### Search for pairs matching query (rate-limit 300 requests per minute)[](https://docs.dexscreener.com/api/reference#get-latest-dex-search)

gethttps://api.dexscreener.com/latest/dex/search

Query parameters

qstringRequiredExample: `SOL/USDC`

Responses

200

Ok

application/json

schemaVersionstringOptional

pairsobject · Pair\[\]Optional

Show properties

get/latest/dex/search

HTTP

Copy

    GET /latest/dex/search?q=text HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    {
      "schemaVersion": "text",
      "pairs": [\
        {\
          "chainId": "text",\
          "dexId": "text",\
          "url": "https://example.com",\
          "pairAddress": "text",\
          "labels": [\
            "text"\
          ],\
          "baseToken": {\
            "address": "text",\
            "name": "text",\
            "symbol": "text"\
          },\
          "quoteToken": {\
            "address": "text",\
            "name": "text",\
            "symbol": "text"\
          },\
          "priceNative": "text",\
          "priceUsd": "text",\
          "txns": {\
            "ANY_ADDITIONAL_PROPERTY": {\
              "buys": 1,\
              "sells": 1\
            }\
          },\
          "volume": {\
            "ANY_ADDITIONAL_PROPERTY": 1\
          },\
          "priceChange": {\
            "ANY_ADDITIONAL_PROPERTY": 1\
          },\
          "liquidity": {\
            "usd": 1,\
            "base": 1,\
            "quote": 1\
          },\
          "fdv": 1,\
          "marketCap": 1,\
          "pairCreatedAt": 1,\
          "info": {\
            "imageUrl": "https://example.com",\
            "websites": [\
              {\
                "url": "https://example.com"\
              }\
            ],\
            "socials": [\
              {\
                "platform": "text",\
                "handle": "text"\
              }\
            ]\
          },\
          "boosts": {\
            "active": 1\
          }\
        }\
      ]
    }

### Get the pools of a given token address (rate-limit 300 requests per minute)[](https://docs.dexscreener.com/api/reference#get-token-pairs-v1-chainid-tokenaddress)

gethttps://api.dexscreener.com/token-pairs/v1/{chainId}/{tokenAddress}

Path parameters

chainIdstringRequiredExample: `solana`

tokenAddressstringRequired

A token addresses

Example: `JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN`

Responses

200

Ok

application/json

chainIdstringOptional

dexIdstringOptional

urlstring · uriOptional

pairAddressstringOptional

labelsstring\[\] · nullableOptional

baseTokenobjectOptional

Show properties

quoteTokenobjectOptional

Show properties

priceNativestringOptional

priceUsdstring · nullableOptional

txnsobjectOptional

Show properties

volumeobjectOptional

Show properties

priceChangeobject · nullableOptional

Show properties

liquidityobject · nullableOptional

Show properties

fdvnumber · nullableOptional

marketCapnumber · nullableOptional

pairCreatedAtinteger · nullableOptional

infoobjectOptional

Show properties

boostsobjectOptional

Show properties

get/token-pairs/v1/{chainId}/{tokenAddress}

HTTP

Copy

    GET /token-pairs/v1/{chainId}/{tokenAddress} HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    [\
      {\
        "chainId": "text",\
        "dexId": "text",\
        "url": "https://example.com",\
        "pairAddress": "text",\
        "labels": [\
          "text"\
        ],\
        "baseToken": {\
          "address": "text",\
          "name": "text",\
          "symbol": "text"\
        },\
        "quoteToken": {\
          "address": "text",\
          "name": "text",\
          "symbol": "text"\
        },\
        "priceNative": "text",\
        "priceUsd": "text",\
        "txns": {\
          "ANY_ADDITIONAL_PROPERTY": {\
            "buys": 1,\
            "sells": 1\
          }\
        },\
        "volume": {\
          "ANY_ADDITIONAL_PROPERTY": 1\
        },\
        "priceChange": {\
          "ANY_ADDITIONAL_PROPERTY": 1\
        },\
        "liquidity": {\
          "usd": 1,\
          "base": 1,\
          "quote": 1\
        },\
        "fdv": 1,\
        "marketCap": 1,\
        "pairCreatedAt": 1,\
        "info": {\
          "imageUrl": "https://example.com",\
          "websites": [\
            {\
              "url": "https://example.com"\
            }\
          ],\
          "socials": [\
            {\
              "platform": "text",\
              "handle": "text"\
            }\
          ]\
        },\
        "boosts": {\
          "active": 1\
        }\
      }\
    ]

### Get one or multiple pairs by token address (rate-limit 300 requests per minute)[](https://docs.dexscreener.com/api/reference#get-tokens-v1-chainid-tokenaddresses)

gethttps://api.dexscreener.com/tokens/v1/{chainId}/{tokenAddresses}

Path parameters

chainIdstringRequiredExample: `solana`

tokenAddressesstringRequired

One or multiple, comma-separated token addresses (up to 30 addresses)

Example: `So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`

Responses

200

Ok

application/json

chainIdstringOptional

dexIdstringOptional

urlstring · uriOptional

pairAddressstringOptional

labelsstring\[\] · nullableOptional

baseTokenobjectOptional

Show properties

quoteTokenobjectOptional

Show properties

priceNativestringOptional

priceUsdstring · nullableOptional

txnsobjectOptional

Show properties

volumeobjectOptional

Show properties

priceChangeobject · nullableOptional

Show properties

liquidityobject · nullableOptional

Show properties

fdvnumber · nullableOptional

marketCapnumber · nullableOptional

pairCreatedAtinteger · nullableOptional

infoobjectOptional

Show properties

boostsobjectOptional

Show properties

get/tokens/v1/{chainId}/{tokenAddresses}

HTTP

Copy

    GET /tokens/v1/{chainId}/{tokenAddresses} HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    [\
      {\
        "chainId": "text",\
        "dexId": "text",\
        "url": "https://example.com",\
        "pairAddress": "text",\
        "labels": [\
          "text"\
        ],\
        "baseToken": {\
          "address": "text",\
          "name": "text",\
          "symbol": "text"\
        },\
        "quoteToken": {\
          "address": "text",\
          "name": "text",\
          "symbol": "text"\
        },\
        "priceNative": "text",\
        "priceUsd": "text",\
        "txns": {\
          "ANY_ADDITIONAL_PROPERTY": {\
            "buys": 1,\
            "sells": 1\
          }\
        },\
        "volume": {\
          "ANY_ADDITIONAL_PROPERTY": 1\
        },\
        "priceChange": {\
          "ANY_ADDITIONAL_PROPERTY": 1\
        },\
        "liquidity": {\
          "usd": 1,\
          "base": 1,\
          "quote": 1\
        },\
        "fdv": 1,\
        "marketCap": 1,\
        "pairCreatedAt": 1,\
        "info": {\
          "imageUrl": "https://example.com",\
          "websites": [\
            {\
              "url": "https://example.com"\
            }\
          ],\
          "socials": [\
            {\
              "platform": "text",\
              "handle": "text"\
            }\
          ]\
        },\
        "boosts": {\
          "active": 1\
        }\
      }\
    ]

### Get trending metas (rate-limit 60 requests per minute)[](https://docs.dexscreener.com/api/reference#get-metas-trending-v1)

gethttps://api.dexscreener.com/metas/trending/v1

Responses

200

Ok

application/json

descriptionstringOptional

iconobjectOptional

Show properties

namestringOptional

slugstringOptional

marketCapnumber · doubleOptional

liquiditynumber · doubleOptional

volumenumber · doubleOptional

tokenCountintegerOptional

marketCapChangeobject · TimeframeStatsOptional

Show properties

marketCapDeltaobject · TimeframeStatsOptional

Show properties

get/metas/trending/v1

HTTP

Copy

    GET /metas/trending/v1 HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    [\
      {\
        "description": "text",\
        "icon": {\
          "type": "text",\
          "value": "text"\
        },\
        "name": "text",\
        "slug": "text",\
        "marketCap": 1,\
        "liquidity": 1,\
        "volume": 1,\
        "tokenCount": 1,\
        "marketCapChange": {\
          "m5": 1,\
          "h1": 1,\
          "h6": 1,\
          "h24": 1\
        },\
        "marketCapDelta": {\
          "m5": 1,\
          "h1": 1,\
          "h6": 1,\
          "h24": 1\
        }\
      }\
    ]

### Get meta information for a given slug (rate-limit 60 requests per minute)[](https://docs.dexscreener.com/api/reference#get-metas-meta-v1-slug)

gethttps://api.dexscreener.com/metas/meta/v1/{slug}

Path parameters

slugstringRequiredExample: `ai`

Responses

200

Ok

application/json

descriptionstringOptional

iconobjectOptional

Show properties

namestringOptional

slugstringOptional

marketCapnumber · doubleOptional

liquiditynumber · doubleOptional

volumenumber · doubleOptional

tokenCountintegerOptional

marketCapChangeobject · TimeframeStatsOptional

Show properties

marketCapDeltaobject · TimeframeStatsOptional

Show properties

pairsobject · Pair\[\]Optional

Show properties

get/metas/meta/v1/{slug}

HTTP

Copy

    GET /metas/meta/v1/{slug} HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    {
      "description": "Artificial intelligence and agents",
      "icon": {
        "type": "emoji",
        "value": "🤖"
      },
      "name": "AI",
      "slug": "ai",
      "marketCap": 100000,
      "liquidity": 100000,
      "volume": 100000,
      "tokenCount": 0,
      "marketCapChange": {
        "m5": 0,
        "h1": 0,
        "h6": 0,
        "h24": 0
      },
      "marketCapDelta": {
        "m5": 100000,
        "h1": 100000,
        "h6": 100000,
        "h24": 100000
      },
      "pairs": []
    }

Last updated 4 months ago

---

# WebSockets | DEX Screener - Docs

For the complete documentation index, see [llms.txt](https://docs.dexscreener.com/llms.txt)
. This page is also available as [Markdown](https://docs.dexscreener.com/api/websockets.md)
.

Copy

On this page

The WebSocket API provides **real-time streaming updates** for token data such as token profiles, boosts, and community take-overs.

### Get the latest token profiles[](https://docs.dexscreener.com/api/websockets#get-token-profiles-latest-v1)

getwss://api.dexscreener.com/token-profiles/latest/v1

Responses

101

Connection Established

application/json

limitintegerOptionalExample: `90`

dataobject · TokenProfile\[\]Optional

Show properties

get/token-profiles/latest/v1

HTTP

Copy

    GET /token-profiles/latest/v1 HTTP/1.1
    Accept: */*
    

101

Connection Established

Copy

    {
      "limit": 90,
      "data": [\
        {\
          "url": "https://example.com",\
          "chainId": "text",\
          "tokenAddress": "text",\
          "icon": "https://example.com",\
          "header": "https://example.com",\
          "description": "text",\
          "links": [\
            {\
              "type": "text",\
              "label": "text",\
              "url": "https://example.com"\
            }\
          ]\
        }\
      ]
    }

### Get recently updated token profiles[](https://docs.dexscreener.com/api/websockets#get-token-profiles-recent-updates-v1)

getwss://api.dexscreener.com/token-profiles/recent-updates/v1

Responses

101

Connection Established

application/json

limitintegerOptionalExample: `90`

dataobject · TokenProfile\[\]Optional

Show properties

get/token-profiles/recent-updates/v1

HTTP

Copy

    GET /token-profiles/recent-updates/v1 HTTP/1.1
    Accept: */*
    

101

Connection Established

Copy

    {
      "limit": 90,
      "data": [\
        {\
          "url": "https://example.com",\
          "chainId": "text",\
          "tokenAddress": "text",\
          "icon": "https://example.com",\
          "header": "https://example.com",\
          "description": "text",\
          "links": [\
            {\
              "type": "text",\
              "label": "text",\
              "url": "https://example.com"\
            }\
          ]\
        }\
      ]
    }

### Get the latest token community takeovers[](https://docs.dexscreener.com/api/websockets#get-community-takeovers-latest-v1)

getwss://api.dexscreener.com/community-takeovers/latest/v1

Responses

101

Connection Established

application/json

limitintegerOptionalExample: `90`

dataobject · CommunityTakeover\[\]Optional

Show properties

get/community-takeovers/latest/v1

HTTP

Copy

    GET /community-takeovers/latest/v1 HTTP/1.1
    Accept: */*
    

101

Connection Established

Copy

    {
      "limit": 90,
      "data": [\
        {\
          "url": "https://example.com",\
          "chainId": "text",\
          "tokenAddress": "text",\
          "icon": "https://example.com",\
          "header": "https://example.com",\
          "description": "text",\
          "links": [\
            {\
              "type": "text",\
              "label": "text",\
              "url": "https://example.com"\
            }\
          ],\
          "claimDate": "2026-01-01T00:00:00.000Z"\
        }\
      ]
    }

### Get the latest ads[](https://docs.dexscreener.com/api/websockets#get-a-ds-latest-v1)

getwss://api.dexscreener.com/ads/latest/v1

Responses

101

Connection Established

application/json

limitintegerOptionalExample: `90`

dataobject · Ad\[\]Optional

Show properties

get/ads/latest/v1

HTTP

Copy

    GET /ads/latest/v1 HTTP/1.1
    Accept: */*
    

101

Connection Established

Copy

    {
      "limit": 90,
      "data": [\
        {\
          "url": "https://example.com",\
          "chainId": "text",\
          "tokenAddress": "text",\
          "date": "2026-01-01T00:00:00.000Z",\
          "type": "text",\
          "durationHours": 1,\
          "impressions": 1\
        }\
      ]
    }

### Get the latest boosted tokens[](https://docs.dexscreener.com/api/websockets#get-token-boosts-latest-v1)

getwss://api.dexscreener.com/token-boosts/latest/v1

Responses

101

Connection Established

application/json

limitintegerOptionalExample: `90`

dataobject · Boost\[\]Optional

Show properties

get/token-boosts/latest/v1

HTTP

Copy

    GET /token-boosts/latest/v1 HTTP/1.1
    Accept: */*
    

101

Connection Established

Copy

    {
      "limit": 90,
      "data": [\
        {\
          "url": "https://example.com",\
          "chainId": "text",\
          "tokenAddress": "text",\
          "amount": 1,\
          "totalAmount": 1,\
          "icon": "https://example.com",\
          "header": "https://example.com",\
          "description": "text",\
          "links": [\
            {\
              "type": "text",\
              "label": "text",\
              "url": "https://example.com"\
            }\
          ]\
        }\
      ]
    }

### Get the tokens with most active boosts[](https://docs.dexscreener.com/api/websockets#get-token-boosts-top-v1)

getwss://api.dexscreener.com/token-boosts/top/v1

Responses

101

Connection Established

application/json

limitintegerOptionalExample: `90`

dataobject · Boost\[\]Optional

Show properties

get/token-boosts/top/v1

HTTP

Copy

    GET /token-boosts/top/v1 HTTP/1.1
    Accept: */*
    

101

Connection Established

Copy

    {
      "limit": 90,
      "data": [\
        {\
          "url": "https://example.com",\
          "chainId": "text",\
          "tokenAddress": "text",\
          "amount": 1,\
          "totalAmount": 1,\
          "icon": "https://example.com",\
          "header": "https://example.com",\
          "description": "text",\
          "links": [\
            {\
              "type": "text",\
              "label": "text",\
              "url": "https://example.com"\
            }\
          ]\
        }\
      ]
    }

Last updated 4 months ago

This site uses cookies to deliver its service and to analyze traffic. By browsing this site, you accept the [privacy policy](https://policies.gitbook.com/privacy/cookies)
.

AcceptReject

---

# API Terms & Conditions | DEX Screener - Docs

For the complete documentation index, see [llms.txt](https://docs.dexscreener.com/llms.txt)
. This page is also available as [Markdown](https://docs.dexscreener.com/api/api-terms-and-conditions.md)
.

Last updated: August 18, 2023

API Terms of Use Agreement[](https://docs.dexscreener.com/api/api-terms-and-conditions#api-terms-of-use-agreement)

-------------------------------------------------------------------------------------------------------------------

This Terms of Use Agreement ("Agreement") is a legally binding contract between you ("You" or "User") and DEX Screener, Inc. a Delaware corporation ("DE", "Company", "We", "Us", or "Our"). It governs your access to and use of our Application Programming Interface (API), any accompanying or related documentation, source code, executable applications, and other materials provided by DEX Screener, Inc. (together \[API + all mentioned items\], the "API Services").

By accessing or using our API Services, you agree to be fully bound by the terms of this Agreement. If you are entering into this Agreement on behalf of a company or other entity, you represent that you are authorized to bind that entity to this agreement's terms.

### 1\. Scope of Use[](https://docs.dexscreener.com/api/api-terms-and-conditions#id-1.-scope-of-use)

You are granted a limited, non-exclusive, non-transferable, non-assignable, and revocable license to use the API Services and any updates. Users cannot utilize the API Services to construct, enhance, or market a product or service whose primary purpose is to compete directly with DEX Screener’s product or the API Services itself.

### 2\. Resell Restrictions[](https://docs.dexscreener.com/api/api-terms-and-conditions#id-2.-resell-restrictions)

You are prohibited from assigning, selling, marketing, licensing, or otherwise dealing in any way with the API Services for any unauthorized purpose, including but not limited to making the API Services, or any portion thereof, available for third parties.

### 3\. Licensing[](https://docs.dexscreener.com/api/api-terms-and-conditions#id-3.-licensing)

The Company continues to own all right, title, interest, and copyright in and to the API Services. Users do not gain ownership of any technological or intellectual property rights in or to the API Services or the data obtained through it.

### 4\. Commercial Use[](https://docs.dexscreener.com/api/api-terms-and-conditions#id-4.-commercial-use)

The API Services may be used for both non-commercial and commercial purposes, subject to the limitations set forth in this Agreement. Users have the option to choose between a free and paid version of the API Services, with the specifications, such as rate limiting and requests per second, detailed during the API Services checkout stage.

### 5\. Termination[](https://docs.dexscreener.com/api/api-terms-and-conditions#id-5.-termination)

We reserve the right to suspend or terminate your access to the API Services and/or this Agreement, at our sole discretion, at any time, with or without notice, and without any liability to you.

### 6\. Service Changes and Notifications[](https://docs.dexscreener.com/api/api-terms-and-conditions#id-6.-service-changes-and-notifications)

DEX Screener, Inc. is committed to providing transparency and advance notice regarding any significant changes to the API. Paying customers will receive notifications about any breaking changes at least 30 days before they are implemented. Similarly, customers with paid subscriptions who are using the API that is slated to be discontinued will be notified at least 3 months in advance. While DEX Screener, Inc. reserves the right to modify or discontinue the API without prior notice, our aim is to ensure our customers are informed and prepared for any alterations.

### 7\. API Support and Modifications[](https://docs.dexscreener.com/api/api-terms-and-conditions#id-7.-api-support-and-modifications)

DEX Screener, Inc. offers support for the API on an as-is basis. It is important to note that while we strive to maintain consistent support, we retain the right to terminate or limit this support as needed. Your satisfaction and understanding are important to us, and we are dedicated to providing a seamless experience even amid any necessary changes.

### 8\. Amendments[](https://docs.dexscreener.com/api/api-terms-and-conditions#id-8.-amendments)

We may modify this Agreement at any time, with such modified terms effective immediately upon posting. By continuing use of the API Services, you accept and agree to be bound by such modifications.

### 9\. Contact Information[](https://docs.dexscreener.com/api/api-terms-and-conditions#id-9.-contact-information)

For any inquiries or notices required or permitted under this Agreement, please contact us:

DEX Screener, Inc. 113 se 1st Ave #640, Miami, Florida 33131, United States of America

Last updated 2 years ago

This site uses cookies to deliver its service and to analyze traffic. By browsing this site, you accept the [privacy policy](https://policies.gitbook.com/privacy/cookies)
.

AcceptReject

---

# Unknown

\> For the complete documentation index, see \[llms.txt\](https://docs.dexscreener.com/llms.txt). Markdown versions of documentation pages are available by appending \`.md\` to page URLs; this page is available as \[Markdown\](https://docs.dexscreener.com/api/reference.md).

# Reference

## GET /token-profiles/latest/v1

> Get the latest token profiles (rate-limit 60 requests per minute)

\`\`\`json
{"openapi":"3.0.3","info":{"title":"DEX Screener API","version":"1.0.0"},"servers":\[{"url":"https://api.dexscreener.com"}\],"paths":{"/token-profiles/latest/v1":{"get":{"tags":\["Token Profiles"\],"summary":"Get the latest token profiles (rate-limit 60 requests per minute)","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenProfile"}}}}}}}},"components":{"schemas":{"TokenProfile":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"chainId":{"type":"string"},"tokenAddress":{"type":"string"},"icon":{"type":"string","format":"uri"},"header":{"type":"string","format":"uri","nullable":true},"description":{"type":"string","nullable":true},"links":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","nullable":true},"label":{"type":"string","nullable":true},"url":{"type":"string","format":"uri"}}},"nullable":true}}}}}}
\`\`\`

## GET /token-profiles/recent-updates/v1

> Get recently updated token profiles (rate-limit 60 requests per minute)

\`\`\`json
{"openapi":"3.0.3","info":{"title":"DEX Screener API","version":"1.0.0"},"servers":\[{"url":"https://api.dexscreener.com"}\],"paths":{"/token-profiles/recent-updates/v1":{"get":{"tags":\["Token Profiles"\],"summary":"Get recently updated token profiles (rate-limit 60 requests per minute)","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenProfile"}}}}}}}},"components":{"schemas":{"TokenProfile":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"chainId":{"type":"string"},"tokenAddress":{"type":"string"},"icon":{"type":"string","format":"uri"},"header":{"type":"string","format":"uri","nullable":true},"description":{"type":"string","nullable":true},"links":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","nullable":true},"label":{"type":"string","nullable":true},"url":{"type":"string","format":"uri"}}},"nullable":true}}}}}}
\`\`\`

## GET /community-takeovers/latest/v1

> Get the latest token community takeovers (rate-limit 60 requests per minute)

\`\`\`json
{"openapi":"3.0.3","info":{"title":"DEX Screener API","version":"1.0.0"},"servers":\[{"url":"https://api.dexscreener.com"}\],"paths":{"/community-takeovers/latest/v1":{"get":{"tags":\["Community Takeovers"\],"summary":"Get the latest token community takeovers (rate-limit 60 requests per minute)","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommunityTakeoverResponse"}}}}}}}},"components":{"schemas":{"CommunityTakeoverResponse":{"type":"array","items":{"$ref":"#/components/schemas/CommunityTakeover"}},"CommunityTakeover":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"chainId":{"type":"string"},"tokenAddress":{"type":"string"},"icon":{"type":"string","format":"uri"},"header":{"type":"string","format":"uri","nullable":true},"description":{"type":"string","nullable":true},"links":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","nullable":true},"label":{"type":"string","nullable":true},"url":{"type":"string","format":"uri"}}},"nullable":true},"claimDate":{"type":"string","format":"date-time"}}}}}}
\`\`\`

## GET /ads/latest/v1

> Get the latest ads (rate-limit 60 requests per minute)

\`\`\`json
{"openapi":"3.0.3","info":{"title":"DEX Screener API","version":"1.0.0"},"servers":\[{"url":"https://api.dexscreener.com"}\],"paths":{"/ads/latest/v1":{"get":{"tags":\["Ads"\],"summary":"Get the latest ads (rate-limit 60 requests per minute)","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsResponse"}}}}}}}},"components":{"schemas":{"AdsResponse":{"type":"array","items":{"$ref":"#/components/schemas/Ad"}},"Ad":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"chainId":{"type":"string"},"tokenAddress":{"type":"string"},"date":{"type":"string","format":"date-time"},"type":{"type":"string"},"durationHours":{"type":"number","nullable":true},"impressions":{"type":"number","nullable":true}}}}}}
\`\`\`

{% openapi src="/files/U2TwZ1VATTZj1hiAXvTH" path="/token-boosts/latest/v1" method="get" %}
\[openapi-spec.yml\](https://198140802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7OmRM9NOmlC1POtFwsnX%2Fuploads%2FyW7tUJPqX1ECjLZX0TfH%2Fopenapi-spec.yml?alt=media\\&token=155a7049-dc39-4be1-aa19-5eeb66388513)
{% endopenapi %}

{% openapi src="/files/U2TwZ1VATTZj1hiAXvTH" path="/token-boosts/top/v1" method="get" %}
\[openapi-spec.yml\](https://198140802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7OmRM9NOmlC1POtFwsnX%2Fuploads%2FyW7tUJPqX1ECjLZX0TfH%2Fopenapi-spec.yml?alt=media\\&token=155a7049-dc39-4be1-aa19-5eeb66388513)
{% endopenapi %}

{% openapi src="/files/U2TwZ1VATTZj1hiAXvTH" path="/orders/v1/{chainId}/{tokenAddress}" method="get" %}
\[openapi-spec.yml\](https://198140802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7OmRM9NOmlC1POtFwsnX%2Fuploads%2FyW7tUJPqX1ECjLZX0TfH%2Fopenapi-spec.yml?alt=media\\&token=155a7049-dc39-4be1-aa19-5eeb66388513)
{% endopenapi %}

{% openapi src="/files/U2TwZ1VATTZj1hiAXvTH" path="/latest/dex/pairs/{chainId}/{pairId}" method="get" %}
\[openapi-spec.yml\](https://198140802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7OmRM9NOmlC1POtFwsnX%2Fuploads%2FyW7tUJPqX1ECjLZX0TfH%2Fopenapi-spec.yml?alt=media\\&token=155a7049-dc39-4be1-aa19-5eeb66388513)
{% endopenapi %}

{% openapi src="/files/U2TwZ1VATTZj1hiAXvTH" path="/latest/dex/search" method="get" %}
\[openapi-spec.yml\](https://198140802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7OmRM9NOmlC1POtFwsnX%2Fuploads%2FyW7tUJPqX1ECjLZX0TfH%2Fopenapi-spec.yml?alt=media\\&token=155a7049-dc39-4be1-aa19-5eeb66388513)
{% endopenapi %}

{% openapi src="/files/U2TwZ1VATTZj1hiAXvTH" path="/token-pairs/v1/{chainId}/{tokenAddress}" method="get" %}
\[openapi-spec.yml\](https://198140802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7OmRM9NOmlC1POtFwsnX%2Fuploads%2FyW7tUJPqX1ECjLZX0TfH%2Fopenapi-spec.yml?alt=media\\&token=155a7049-dc39-4be1-aa19-5eeb66388513)
{% endopenapi %}

{% openapi src="/files/U2TwZ1VATTZj1hiAXvTH" path="/tokens/v1/{chainId}/{tokenAddresses}" method="get" %}
\[openapi-spec.yml\](https://198140802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7OmRM9NOmlC1POtFwsnX%2Fuploads%2FyW7tUJPqX1ECjLZX0TfH%2Fopenapi-spec.yml?alt=media\\&token=155a7049-dc39-4be1-aa19-5eeb66388513)
{% endopenapi %}

## GET /metas/trending/v1

> Get trending metas (rate-limit 60 requests per minute)

\`\`\`json
{"openapi":"3.0.3","info":{"title":"DEX Screener API","version":"1.0.0"},"servers":\[{"url":"https://api.dexscreener.com"}\],"paths":{"/metas/trending/v1":{"get":{"tags":\["Metas"\],"summary":"Get trending metas (rate-limit 60 requests per minute)","responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetasTrendingResponse"}}}}}}}},"components":{"schemas":{"MetasTrendingResponse":{"type":"array","items":{"$ref":"#/components/schemas/Meta"}},"Meta":{"type":"object","properties":{"description":{"type":"string"},"icon":{"type":"object","properties":{"type":{"type":"string"},"value":{"type":"string"}}},"name":{"type":"string"},"slug":{"type":"string"},"marketCap":{"type":"number","format":"double"},"liquidity":{"type":"number","format":"double"},"volume":{"type":"number","format":"double"},"tokenCount":{"type":"integer"},"marketCapChange":{"$ref":"#/components/schemas/TimeframeStats"},"marketCapDelta":{"$ref":"#/components/schemas/TimeframeStats"}}},"TimeframeStats":{"type":"object","required":\["m5","h1","h6","h24"\],"properties":{"m5":{"type":"number","format":"double"},"h1":{"type":"number","format":"double"},"h6":{"type":"number","format":"double"},"h24":{"type":"number","format":"double"}}}}}}
\`\`\`

## GET /metas/meta/v1/{slug}

> Get meta information for a given slug (rate-limit 60 requests per minute)

\`\`\`json
{"openapi":"3.0.3","info":{"title":"DEX Screener API","version":"1.0.0"},"servers":\[{"url":"https://api.dexscreener.com"}\],"paths":{"/metas/meta/v1/{slug}":{"get":{"tags":\["Metas"\],"summary":"Get meta information for a given slug (rate-limit 60 requests per minute)","parameters":\[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}\],"responses":{"200":{"description":"Ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaWithPairsResponse"}}}}}}}},"components":{"schemas":{"MetaWithPairsResponse":{"allOf":\[{"$ref":"#/components/schemas/Meta"},{"type":"object","properties":{"pairs":{"type":"array","items":{"$ref":"#/components/schemas/Pair"}}}}\]},"Meta":{"type":"object","properties":{"description":{"type":"string"},"icon":{"type":"object","properties":{"type":{"type":"string"},"value":{"type":"string"}}},"name":{"type":"string"},"slug":{"type":"string"},"marketCap":{"type":"number","format":"double"},"liquidity":{"type":"number","format":"double"},"volume":{"type":"number","format":"double"},"tokenCount":{"type":"integer"},"marketCapChange":{"$ref":"#/components/schemas/TimeframeStats"},"marketCapDelta":{"$ref":"#/components/schemas/TimeframeStats"}}},"TimeframeStats":{"type":"object","required":\["m5","h1","h6","h24"\],"properties":{"m5":{"type":"number","format":"double"},"h1":{"type":"number","format":"double"},"h6":{"type":"number","format":"double"},"h24":{"type":"number","format":"double"}}},"Pair":{"type":"object","properties":{"chainId":{"type":"string"},"dexId":{"type":"string"},"url":{"type":"string","format":"uri"},"pairAddress":{"type":"string"},"labels":{"type":"array","items":{"type":"string"},"nullable":true},"baseToken":{"type":"object","properties":{"address":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"}}},"quoteToken":{"type":"object","properties":{"address":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"symbol":{"type":"string","nullable":true}}},"priceNative":{"type":"string"},"priceUsd":{"type":"string","nullable":true},"txns":{"type":"object","additionalProperties":{"type":"object","properties":{"buys":{"type":"integer"},"sells":{"type":"integer"}}}},"volume":{"type":"object","additionalProperties":{"type":"number"}},"priceChange":{"type":"object","additionalProperties":{"type":"number"},"nullable":true},"liquidity":{"type":"object","properties":{"usd":{"type":"number","nullable":true},"base":{"type":"number"},"quote":{"type":"number"}},"nullable":true},"fdv":{"type":"number","nullable":true},"marketCap":{"type":"number","nullable":true},"pairCreatedAt":{"type":"integer","nullable":true},"info":{"type":"object","properties":{"imageUrl":{"type":"string","format":"uri","nullable":true},"websites":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"}}},"nullable":true},"socials":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string"},"handle":{"type":"string"}}},"nullable":true}}},"boosts":{"type":"object","properties":{"active":{"type":"integer"}}}}}}}}
\`\`\`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the \`ask\` query parameter, and the optional \`goal\` query parameter:

\`\`\`
GET https://docs.dexscreener.com/api/reference.md?ask=<question>&goal=<endgoal>
\`\`\`

\`ask\` is the immediate question: it should be specific, self-contained, and written in natural language.
\`goal\` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.

---

# Unknown

\> For the complete documentation index, see \[llms.txt\](https://docs.dexscreener.com/llms.txt). Markdown versions of documentation pages are available by appending \`.md\` to page URLs; this page is available as \[Markdown\](https://docs.dexscreener.com/api/websockets.md).

# WebSockets

The WebSocket API provides \*\*real-time streaming updates\*\* for token data such as token profiles, boosts, and community take-overs.

## GET /token-profiles/latest/v1

> Get the latest token profiles

\`\`\`json
{"openapi":"3.0.3","info":{"title":"DEX Screener Websocket API","version":"1.0.0"},"servers":\[{"url":"wss://api.dexscreener.com"}\],"paths":{"/token-profiles/latest/v1":{"get":{"tags":\["Token Profiles"\],"summary":"Get the latest token profiles","responses":{"101":{"description":"Connection Established","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenProfileHandshakeResponse"}}}}}}}},"components":{"schemas":{"TokenProfileHandshakeResponse":{"type":"object","properties":{"limit":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/TokenProfile"}}}},"TokenProfile":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"chainId":{"type":"string"},"tokenAddress":{"type":"string"},"icon":{"type":"string","format":"uri"},"header":{"type":"string","format":"uri","nullable":true},"description":{"type":"string","nullable":true},"links":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","nullable":true},"label":{"type":"string","nullable":true},"url":{"type":"string","format":"uri"}}},"nullable":true}}}}}}
\`\`\`

## GET /token-profiles/recent-updates/v1

> Get recently updated token profiles

\`\`\`json
{"openapi":"3.0.3","info":{"title":"DEX Screener Websocket API","version":"1.0.0"},"servers":\[{"url":"wss://api.dexscreener.com"}\],"paths":{"/token-profiles/recent-updates/v1":{"get":{"tags":\["Token Profiles"\],"summary":"Get recently updated token profiles","responses":{"101":{"description":"Connection Established","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenProfileHandshakeResponse"}}}}}}}},"components":{"schemas":{"TokenProfileHandshakeResponse":{"type":"object","properties":{"limit":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/TokenProfile"}}}},"TokenProfile":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"chainId":{"type":"string"},"tokenAddress":{"type":"string"},"icon":{"type":"string","format":"uri"},"header":{"type":"string","format":"uri","nullable":true},"description":{"type":"string","nullable":true},"links":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","nullable":true},"label":{"type":"string","nullable":true},"url":{"type":"string","format":"uri"}}},"nullable":true}}}}}}
\`\`\`

## GET /community-takeovers/latest/v1

> Get the latest token community takeovers

\`\`\`json
{"openapi":"3.0.3","info":{"title":"DEX Screener Websocket API","version":"1.0.0"},"servers":\[{"url":"wss://api.dexscreener.com"}\],"paths":{"/community-takeovers/latest/v1":{"get":{"tags":\["Community Takeovers"\],"summary":"Get the latest token community takeovers","responses":{"101":{"description":"Connection Established","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommunityTakeoverHandshakeResponse"}}}}}}}},"components":{"schemas":{"CommunityTakeoverHandshakeResponse":{"type":"object","properties":{"limit":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/CommunityTakeover"}}}},"CommunityTakeover":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"chainId":{"type":"string"},"tokenAddress":{"type":"string"},"icon":{"type":"string","format":"uri"},"header":{"type":"string","format":"uri","nullable":true},"description":{"type":"string","nullable":true},"links":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","nullable":true},"label":{"type":"string","nullable":true},"url":{"type":"string","format":"uri"}}},"nullable":true},"claimDate":{"type":"string","format":"date-time"}}}}}}
\`\`\`

## GET /ads/latest/v1

> Get the latest ads

\`\`\`json
{"openapi":"3.0.3","info":{"title":"DEX Screener Websocket API","version":"1.0.0"},"servers":\[{"url":"wss://api.dexscreener.com"}\],"paths":{"/ads/latest/v1":{"get":{"tags":\["Ads"\],"summary":"Get the latest ads","responses":{"101":{"description":"Connection Established","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsHandshakeResponse"}}}}}}}},"components":{"schemas":{"AdsHandshakeResponse":{"type":"object","properties":{"limit":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Ad"}}}},"Ad":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"chainId":{"type":"string"},"tokenAddress":{"type":"string"},"date":{"type":"string","format":"date-time"},"type":{"type":"string"},"durationHours":{"type":"number","nullable":true},"impressions":{"type":"number","nullable":true}}}}}}
\`\`\`

## GET /token-boosts/latest/v1

> Get the latest boosted tokens

\`\`\`json
{"openapi":"3.0.3","info":{"title":"DEX Screener Websocket API","version":"1.0.0"},"servers":\[{"url":"wss://api.dexscreener.com"}\],"paths":{"/token-boosts/latest/v1":{"get":{"tags":\["Token Boosts"\],"summary":"Get the latest boosted tokens","responses":{"101":{"description":"Connection Established","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoostHandshakeResponse"}}}}}}}},"components":{"schemas":{"BoostHandshakeResponse":{"type":"object","properties":{"limit":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Boost"}}}},"Boost":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"chainId":{"type":"string"},"tokenAddress":{"type":"string"},"amount":{"type":"number"},"totalAmount":{"type":"number"},"icon":{"type":"string","format":"uri","nullable":true},"header":{"type":"string","format":"uri","nullable":true},"description":{"type":"string","nullable":true},"links":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","nullable":true},"label":{"type":"string","nullable":true},"url":{"type":"string","format":"uri"}}},"nullable":true}}}}}}
\`\`\`

## GET /token-boosts/top/v1

> Get the tokens with most active boosts

\`\`\`json
{"openapi":"3.0.3","info":{"title":"DEX Screener Websocket API","version":"1.0.0"},"servers":\[{"url":"wss://api.dexscreener.com"}\],"paths":{"/token-boosts/top/v1":{"get":{"tags":\["Token Boosts"\],"summary":"Get the tokens with most active boosts","responses":{"101":{"description":"Connection Established","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoostHandshakeResponse"}}}}}}}},"components":{"schemas":{"BoostHandshakeResponse":{"type":"object","properties":{"limit":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Boost"}}}},"Boost":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"chainId":{"type":"string"},"tokenAddress":{"type":"string"},"amount":{"type":"number"},"totalAmount":{"type":"number"},"icon":{"type":"string","format":"uri","nullable":true},"header":{"type":"string","format":"uri","nullable":true},"description":{"type":"string","nullable":true},"links":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","nullable":true},"label":{"type":"string","nullable":true},"url":{"type":"string","format":"uri"}}},"nullable":true}}}}}}
\`\`\`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the \`ask\` query parameter, and the optional \`goal\` query parameter:

\`\`\`
GET https://docs.dexscreener.com/api/websockets.md?ask=<question>&goal=<endgoal>
\`\`\`

\`ask\` is the immediate question: it should be specific, self-contained, and written in natural language.
\`goal\` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.

---

# Unknown

\> For the complete documentation index, see \[llms.txt\](https://docs.dexscreener.com/llms.txt). Markdown versions of documentation pages are available by appending \`.md\` to page URLs; this page is available as \[Markdown\](https://docs.dexscreener.com/api/api-terms-and-conditions.md).

# API Terms & Conditions

Last updated: August 18, 2023

## API Terms of Use Agreement

This Terms of Use Agreement ("Agreement") is a legally binding contract between you ("You" or "User") and DEX Screener, Inc. a Delaware corporation ("DE", "Company", "We", "Us", or "Our"). It governs your access to and use of our Application Programming Interface (API), any accompanying or related documentation, source code, executable applications, and other materials provided by DEX Screener, Inc. (together \\\[API + all mentioned items\], the "API Services").

By accessing or using our API Services, you agree to be fully bound by the terms of this Agreement. If you are entering into this Agreement on behalf of a company or other entity, you represent that you are authorized to bind that entity to this agreement's terms.

### 1. Scope of Use

You are granted a limited, non-exclusive, non-transferable, non-assignable, and revocable license to use the API Services and any updates. Users cannot utilize the API Services to construct, enhance, or market a product or service whose primary purpose is to compete directly with DEX Screener’s product or the API Services itself.

### 2. Resell Restrictions

You are prohibited from assigning, selling, marketing, licensing, or otherwise dealing in any way with the API Services for any unauthorized purpose, including but not limited to making the API Services, or any portion thereof, available for third parties.

### 3. Licensing

The Company continues to own all right, title, interest, and copyright in and to the API Services. Users do not gain ownership of any technological or intellectual property rights in or to the API Services or the data obtained through it.

### 4. Commercial Use

The API Services may be used for both non-commercial and commercial purposes, subject to the limitations set forth in this Agreement. Users have the option to choose between a free and paid version of the API Services, with the specifications, such as rate limiting and requests per second, detailed during the API Services checkout stage.

### 5. Termination

We reserve the right to suspend or terminate your access to the API Services and/or this Agreement, at our sole discretion, at any time, with or without notice, and without any liability to you.

### 6. Service Changes and Notifications

DEX Screener, Inc. is committed to providing transparency and advance notice regarding any significant changes to the API. Paying customers will receive notifications about any breaking changes at least 30 days before they are implemented. Similarly, customers with paid subscriptions who are using the API that is slated to be discontinued will be notified at least 3 months in advance. While DEX Screener, Inc. reserves the right to modify or discontinue the API without prior notice, our aim is to ensure our customers are informed and prepared for any alterations.

### 7. API Support and Modifications

DEX Screener, Inc. offers support for the API on an as-is basis. It is important to note that while we strive to maintain consistent support, we retain the right to terminate or limit this support as needed. Your satisfaction and understanding are important to us, and we are dedicated to providing a seamless experience even amid any necessary changes.

### 8. Amendments

We may modify this Agreement at any time, with such modified terms effective immediately upon posting. By continuing use of the API Services, you accept and agree to be bound by such modifications.

### 9. Contact Information

For any inquiries or notices required or permitted under this Agreement, please contact us:

DEX Screener, Inc. 113 se 1st Ave #640, Miami, Florida 33131, United States of America


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the \`ask\` query parameter, and the optional \`goal\` query parameter:

\`\`\`
GET https://docs.dexscreener.com/api/api-terms-and-conditions.md?ask=<question>&goal=<endgoal>
\`\`\`

\`ask\` is the immediate question: it should be specific, self-contained, and written in natural language.
\`goal\` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.

---

# Reference | DEX Screener - Docs

For the complete documentation index, see [llms.txt](https://docs.dexscreener.com/llms.txt)
. This page is also available as [Markdown](https://docs.dexscreener.com/api/reference.md)
.

Copy

On this page

### Get the latest token profiles (rate-limit 60 requests per minute)[](https://docs.dexscreener.com/api#get-token-profiles-latest-v1)

gethttps://api.dexscreener.com/token-profiles/latest/v1

Responses

200

Ok

application/json

urlstring · uriOptional

chainIdstringOptional

tokenAddressstringOptional

iconstring · uriOptional

headerstring · uri · nullableOptional

descriptionstring · nullableOptional

linksobject\[\] · nullableOptional

Show properties

get/token-profiles/latest/v1

HTTP

Copy

    GET /token-profiles/latest/v1 HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    {
      "url": "https://example.com",
      "chainId": "text",
      "tokenAddress": "text",
      "icon": "https://example.com",
      "header": "https://example.com",
      "description": "text",
      "links": [\
        {\
          "type": "text",\
          "label": "text",\
          "url": "https://example.com"\
        }\
      ]
    }

### Get recently updated token profiles (rate-limit 60 requests per minute)[](https://docs.dexscreener.com/api#get-token-profiles-recent-updates-v1)

gethttps://api.dexscreener.com/token-profiles/recent-updates/v1

Responses

200

Ok

application/json

urlstring · uriOptional

chainIdstringOptional

tokenAddressstringOptional

iconstring · uriOptional

headerstring · uri · nullableOptional

descriptionstring · nullableOptional

linksobject\[\] · nullableOptional

Show properties

get/token-profiles/recent-updates/v1

HTTP

Copy

    GET /token-profiles/recent-updates/v1 HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    {
      "url": "https://example.com",
      "chainId": "text",
      "tokenAddress": "text",
      "icon": "https://example.com",
      "header": "https://example.com",
      "description": "text",
      "links": [\
        {\
          "type": "text",\
          "label": "text",\
          "url": "https://example.com"\
        }\
      ]
    }

### Get the latest token community takeovers (rate-limit 60 requests per minute)[](https://docs.dexscreener.com/api#get-community-takeovers-latest-v1)

gethttps://api.dexscreener.com/community-takeovers/latest/v1

Responses

200

Ok

application/json

urlstring · uriOptional

chainIdstringOptional

tokenAddressstringOptional

iconstring · uriOptional

headerstring · uri · nullableOptional

descriptionstring · nullableOptional

linksobject\[\] · nullableOptional

Show properties

claimDatestring · date-timeOptional

get/community-takeovers/latest/v1

HTTP

Copy

    GET /community-takeovers/latest/v1 HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    [\
      {\
        "url": "https://example.com",\
        "chainId": "text",\
        "tokenAddress": "text",\
        "icon": "https://example.com",\
        "header": "https://example.com",\
        "description": "text",\
        "links": [\
          {\
            "type": "text",\
            "label": "text",\
            "url": "https://example.com"\
          }\
        ],\
        "claimDate": "2026-01-01T00:00:00.000Z"\
      }\
    ]

### Get the latest ads (rate-limit 60 requests per minute)[](https://docs.dexscreener.com/api#get-a-ds-latest-v1)

gethttps://api.dexscreener.com/ads/latest/v1

Responses

200

Ok

application/json

urlstring · uriOptional

chainIdstringOptional

tokenAddressstringOptional

datestring · date-timeOptional

typestringOptional

durationHoursnumber · nullableOptional

impressionsnumber · nullableOptional

get/ads/latest/v1

HTTP

Copy

    GET /ads/latest/v1 HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    [\
      {\
        "url": "https://example.com",\
        "chainId": "text",\
        "tokenAddress": "text",\
        "date": "2026-01-01T00:00:00.000Z",\
        "type": "text",\
        "durationHours": 1,\
        "impressions": 1\
      }\
    ]

### Get the latest boosted tokens (rate-limit 60 requests per minute)[](https://docs.dexscreener.com/api#get-token-boosts-latest-v1)

gethttps://api.dexscreener.com/token-boosts/latest/v1

Responses

200

Ok

application/json

urlstring · uriOptional

chainIdstringOptional

tokenAddressstringOptional

amountnumberOptional

totalAmountnumberOptional

iconstring · uri · nullableOptional

headerstring · uri · nullableOptional

descriptionstring · nullableOptional

linksobject\[\] · nullableOptional

Show properties

get/token-boosts/latest/v1

HTTP

Copy

    GET /token-boosts/latest/v1 HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    {
      "url": "https://example.com",
      "chainId": "text",
      "tokenAddress": "text",
      "amount": 1,
      "totalAmount": 1,
      "icon": "https://example.com",
      "header": "https://example.com",
      "description": "text",
      "links": [\
        {\
          "type": "text",\
          "label": "text",\
          "url": "https://example.com"\
        }\
      ]
    }

### Get the tokens with most active boosts (rate-limit 60 requests per minute)[](https://docs.dexscreener.com/api#get-token-boosts-top-v1)

gethttps://api.dexscreener.com/token-boosts/top/v1

Responses

200

Ok

application/json

urlstring · uriOptional

chainIdstringOptional

tokenAddressstringOptional

amountnumberOptional

totalAmountnumberOptional

iconstring · uri · nullableOptional

headerstring · uri · nullableOptional

descriptionstring · nullableOptional

linksobject\[\] · nullableOptional

Show properties

get/token-boosts/top/v1

HTTP

Copy

    GET /token-boosts/top/v1 HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    {
      "url": "https://example.com",
      "chainId": "text",
      "tokenAddress": "text",
      "amount": 1,
      "totalAmount": 1,
      "icon": "https://example.com",
      "header": "https://example.com",
      "description": "text",
      "links": [\
        {\
          "type": "text",\
          "label": "text",\
          "url": "https://example.com"\
        }\
      ]
    }

### Check paid orders for a token (rate-limit 60 requests per minute)[](https://docs.dexscreener.com/api#get-orders-v1-chainid-tokenaddress)

gethttps://api.dexscreener.com/orders/v1/{chainId}/{tokenAddress}

Path parameters

chainIdstringRequiredExample: `solana`

tokenAddressstringRequiredExample: `A55XjvzRU4KtR3Lrys8PpLZQvPojPqvnv5bJVHMYy3Jv`

Responses

200

Ok

application/json

typestring · enumOptionalPossible values: `tokenProfile``communityTakeover``tokenAd``trendingBarAd`

statusstring · enumOptionalPossible values: `processing``cancelled``on-hold``approved``rejected`

paymentTimestampnumberOptional

get/orders/v1/{chainId}/{tokenAddress}

HTTP

Copy

    GET /orders/v1/{chainId}/{tokenAddress} HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    [\
      {\
        "type": "tokenProfile",\
        "status": "processing",\
        "paymentTimestamp": 1\
      }\
    ]

### Get one or multiple pairs by chain and pair address (rate-limit 300 requests per minute)[](https://docs.dexscreener.com/api#get-latest-dex-pairs-chainid-pairid)

gethttps://api.dexscreener.com/latest/dex/pairs/{chainId}/{pairId}

Path parameters

chainIdstringRequiredExample: `solana`

pairIdstringRequiredExample: `JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN`

Responses

200

Ok

application/json

schemaVersionstringOptional

pairsobject · Pair\[\] · nullableOptional

Show properties

get/latest/dex/pairs/{chainId}/{pairId}

HTTP

Copy

    GET /latest/dex/pairs/{chainId}/{pairId} HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    {
      "schemaVersion": "text",
      "pairs": [\
        {\
          "chainId": "text",\
          "dexId": "text",\
          "url": "https://example.com",\
          "pairAddress": "text",\
          "labels": [\
            "text"\
          ],\
          "baseToken": {\
            "address": "text",\
            "name": "text",\
            "symbol": "text"\
          },\
          "quoteToken": {\
            "address": "text",\
            "name": "text",\
            "symbol": "text"\
          },\
          "priceNative": "text",\
          "priceUsd": "text",\
          "txns": {\
            "ANY_ADDITIONAL_PROPERTY": {\
              "buys": 1,\
              "sells": 1\
            }\
          },\
          "volume": {\
            "ANY_ADDITIONAL_PROPERTY": 1\
          },\
          "priceChange": {\
            "ANY_ADDITIONAL_PROPERTY": 1\
          },\
          "liquidity": {\
            "usd": 1,\
            "base": 1,\
            "quote": 1\
          },\
          "fdv": 1,\
          "marketCap": 1,\
          "pairCreatedAt": 1,\
          "info": {\
            "imageUrl": "https://example.com",\
            "websites": [\
              {\
                "url": "https://example.com"\
              }\
            ],\
            "socials": [\
              {\
                "platform": "text",\
                "handle": "text"\
              }\
            ]\
          },\
          "boosts": {\
            "active": 1\
          }\
        }\
      ]
    }

### Search for pairs matching query (rate-limit 300 requests per minute)[](https://docs.dexscreener.com/api#get-latest-dex-search)

gethttps://api.dexscreener.com/latest/dex/search

Query parameters

qstringRequiredExample: `SOL/USDC`

Responses

200

Ok

application/json

schemaVersionstringOptional

pairsobject · Pair\[\]Optional

Show properties

get/latest/dex/search

HTTP

Copy

    GET /latest/dex/search?q=text HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    {
      "schemaVersion": "text",
      "pairs": [\
        {\
          "chainId": "text",\
          "dexId": "text",\
          "url": "https://example.com",\
          "pairAddress": "text",\
          "labels": [\
            "text"\
          ],\
          "baseToken": {\
            "address": "text",\
            "name": "text",\
            "symbol": "text"\
          },\
          "quoteToken": {\
            "address": "text",\
            "name": "text",\
            "symbol": "text"\
          },\
          "priceNative": "text",\
          "priceUsd": "text",\
          "txns": {\
            "ANY_ADDITIONAL_PROPERTY": {\
              "buys": 1,\
              "sells": 1\
            }\
          },\
          "volume": {\
            "ANY_ADDITIONAL_PROPERTY": 1\
          },\
          "priceChange": {\
            "ANY_ADDITIONAL_PROPERTY": 1\
          },\
          "liquidity": {\
            "usd": 1,\
            "base": 1,\
            "quote": 1\
          },\
          "fdv": 1,\
          "marketCap": 1,\
          "pairCreatedAt": 1,\
          "info": {\
            "imageUrl": "https://example.com",\
            "websites": [\
              {\
                "url": "https://example.com"\
              }\
            ],\
            "socials": [\
              {\
                "platform": "text",\
                "handle": "text"\
              }\
            ]\
          },\
          "boosts": {\
            "active": 1\
          }\
        }\
      ]
    }

### Get the pools of a given token address (rate-limit 300 requests per minute)[](https://docs.dexscreener.com/api#get-token-pairs-v1-chainid-tokenaddress)

gethttps://api.dexscreener.com/token-pairs/v1/{chainId}/{tokenAddress}

Path parameters

chainIdstringRequiredExample: `solana`

tokenAddressstringRequired

A token addresses

Example: `JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN`

Responses

200

Ok

application/json

chainIdstringOptional

dexIdstringOptional

urlstring · uriOptional

pairAddressstringOptional

labelsstring\[\] · nullableOptional

baseTokenobjectOptional

Show properties

quoteTokenobjectOptional

Show properties

priceNativestringOptional

priceUsdstring · nullableOptional

txnsobjectOptional

Show properties

volumeobjectOptional

Show properties

priceChangeobject · nullableOptional

Show properties

liquidityobject · nullableOptional

Show properties

fdvnumber · nullableOptional

marketCapnumber · nullableOptional

pairCreatedAtinteger · nullableOptional

infoobjectOptional

Show properties

boostsobjectOptional

Show properties

get/token-pairs/v1/{chainId}/{tokenAddress}

HTTP

Copy

    GET /token-pairs/v1/{chainId}/{tokenAddress} HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    [\
      {\
        "chainId": "text",\
        "dexId": "text",\
        "url": "https://example.com",\
        "pairAddress": "text",\
        "labels": [\
          "text"\
        ],\
        "baseToken": {\
          "address": "text",\
          "name": "text",\
          "symbol": "text"\
        },\
        "quoteToken": {\
          "address": "text",\
          "name": "text",\
          "symbol": "text"\
        },\
        "priceNative": "text",\
        "priceUsd": "text",\
        "txns": {\
          "ANY_ADDITIONAL_PROPERTY": {\
            "buys": 1,\
            "sells": 1\
          }\
        },\
        "volume": {\
          "ANY_ADDITIONAL_PROPERTY": 1\
        },\
        "priceChange": {\
          "ANY_ADDITIONAL_PROPERTY": 1\
        },\
        "liquidity": {\
          "usd": 1,\
          "base": 1,\
          "quote": 1\
        },\
        "fdv": 1,\
        "marketCap": 1,\
        "pairCreatedAt": 1,\
        "info": {\
          "imageUrl": "https://example.com",\
          "websites": [\
            {\
              "url": "https://example.com"\
            }\
          ],\
          "socials": [\
            {\
              "platform": "text",\
              "handle": "text"\
            }\
          ]\
        },\
        "boosts": {\
          "active": 1\
        }\
      }\
    ]

### Get one or multiple pairs by token address (rate-limit 300 requests per minute)[](https://docs.dexscreener.com/api#get-tokens-v1-chainid-tokenaddresses)

gethttps://api.dexscreener.com/tokens/v1/{chainId}/{tokenAddresses}

Path parameters

chainIdstringRequiredExample: `solana`

tokenAddressesstringRequired

One or multiple, comma-separated token addresses (up to 30 addresses)

Example: `So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`

Responses

200

Ok

application/json

chainIdstringOptional

dexIdstringOptional

urlstring · uriOptional

pairAddressstringOptional

labelsstring\[\] · nullableOptional

baseTokenobjectOptional

Show properties

quoteTokenobjectOptional

Show properties

priceNativestringOptional

priceUsdstring · nullableOptional

txnsobjectOptional

Show properties

volumeobjectOptional

Show properties

priceChangeobject · nullableOptional

Show properties

liquidityobject · nullableOptional

Show properties

fdvnumber · nullableOptional

marketCapnumber · nullableOptional

pairCreatedAtinteger · nullableOptional

infoobjectOptional

Show properties

boostsobjectOptional

Show properties

get/tokens/v1/{chainId}/{tokenAddresses}

HTTP

Copy

    GET /tokens/v1/{chainId}/{tokenAddresses} HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    [\
      {\
        "chainId": "text",\
        "dexId": "text",\
        "url": "https://example.com",\
        "pairAddress": "text",\
        "labels": [\
          "text"\
        ],\
        "baseToken": {\
          "address": "text",\
          "name": "text",\
          "symbol": "text"\
        },\
        "quoteToken": {\
          "address": "text",\
          "name": "text",\
          "symbol": "text"\
        },\
        "priceNative": "text",\
        "priceUsd": "text",\
        "txns": {\
          "ANY_ADDITIONAL_PROPERTY": {\
            "buys": 1,\
            "sells": 1\
          }\
        },\
        "volume": {\
          "ANY_ADDITIONAL_PROPERTY": 1\
        },\
        "priceChange": {\
          "ANY_ADDITIONAL_PROPERTY": 1\
        },\
        "liquidity": {\
          "usd": 1,\
          "base": 1,\
          "quote": 1\
        },\
        "fdv": 1,\
        "marketCap": 1,\
        "pairCreatedAt": 1,\
        "info": {\
          "imageUrl": "https://example.com",\
          "websites": [\
            {\
              "url": "https://example.com"\
            }\
          ],\
          "socials": [\
            {\
              "platform": "text",\
              "handle": "text"\
            }\
          ]\
        },\
        "boosts": {\
          "active": 1\
        }\
      }\
    ]

### Get trending metas (rate-limit 60 requests per minute)[](https://docs.dexscreener.com/api#get-metas-trending-v1)

gethttps://api.dexscreener.com/metas/trending/v1

Responses

200

Ok

application/json

descriptionstringOptional

iconobjectOptional

Show properties

namestringOptional

slugstringOptional

marketCapnumber · doubleOptional

liquiditynumber · doubleOptional

volumenumber · doubleOptional

tokenCountintegerOptional

marketCapChangeobject · TimeframeStatsOptional

Show properties

marketCapDeltaobject · TimeframeStatsOptional

Show properties

get/metas/trending/v1

HTTP

Copy

    GET /metas/trending/v1 HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    [\
      {\
        "description": "text",\
        "icon": {\
          "type": "text",\
          "value": "text"\
        },\
        "name": "text",\
        "slug": "text",\
        "marketCap": 1,\
        "liquidity": 1,\
        "volume": 1,\
        "tokenCount": 1,\
        "marketCapChange": {\
          "m5": 1,\
          "h1": 1,\
          "h6": 1,\
          "h24": 1\
        },\
        "marketCapDelta": {\
          "m5": 1,\
          "h1": 1,\
          "h6": 1,\
          "h24": 1\
        }\
      }\
    ]

### Get meta information for a given slug (rate-limit 60 requests per minute)[](https://docs.dexscreener.com/api#get-metas-meta-v1-slug)

gethttps://api.dexscreener.com/metas/meta/v1/{slug}

Path parameters

slugstringRequiredExample: `ai`

Responses

200

Ok

application/json

descriptionstringOptional

iconobjectOptional

Show properties

namestringOptional

slugstringOptional

marketCapnumber · doubleOptional

liquiditynumber · doubleOptional

volumenumber · doubleOptional

tokenCountintegerOptional

marketCapChangeobject · TimeframeStatsOptional

Show properties

marketCapDeltaobject · TimeframeStatsOptional

Show properties

pairsobject · Pair\[\]Optional

Show properties

get/metas/meta/v1/{slug}

HTTP

Copy

    GET /metas/meta/v1/{slug} HTTP/1.1
    Host: api.dexscreener.com
    Accept: */*
    

Test it

200

Ok

Copy

    {
      "description": "Artificial intelligence and agents",
      "icon": {
        "type": "emoji",
        "value": "🤖"
      },
      "name": "AI",
      "slug": "ai",
      "marketCap": 100000,
      "liquidity": 100000,
      "volume": 100000,
      "tokenCount": 0,
      "marketCapChange": {
        "m5": 0,
        "h1": 0,
        "h6": 0,
        "h24": 0
      },
      "marketCapDelta": {
        "m5": 100000,
        "h1": 100000,
        "h6": 100000,
        "h24": 100000
      },
      "pairs": []
    }

Last updated 4 months ago

This site uses cookies to deliver its service and to analyze traffic. By browsing this site, you accept the [privacy policy](https://policies.gitbook.com/privacy/cookies)
.

AcceptReject

---