Reference

DEX Screener API reference

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

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

Response

200

Ok

Body

application/json

urlstring (uri)

chainIdstring

tokenAddressstring

iconstring (uri)

headernullable string (uri)

descriptionnullable string

linksnullable array of object

Request

JavaScriptCurlPython

const response = await fetch('https://api.dexscreener.com/token-profiles/latest/v1', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "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 boosted tokens (rate-limit 60 requests per minute)

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

Response

200

Ok

Body

application/json

urlstring (uri)

chainIdstring

tokenAddressstring

amountnumber

totalAmountnumber

iconnullable string (uri)

headernullable string (uri)

descriptionnullable string

linksnullable array of object

Request

JavaScriptCurlPython

const response = await fetch('https://api.dexscreener.com/token-boosts/latest/v1', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "url": "https://example.com",
  "chainId": "text",
  "tokenAddress": "text",
  "amount": 0,
  "totalAmount": 0,
  "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)

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

Response

200

Ok

Body

application/json

urlstring (uri)

chainIdstring

tokenAddressstring

amountnumber

totalAmountnumber

iconnullable string (uri)

headernullable string (uri)

descriptionnullable string

linksnullable array of object

Request

JavaScriptCurlPython

const response = await fetch('https://api.dexscreener.com/token-boosts/top/v1', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

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

Check orders paid for of token (rate-limit 60 requests per minute)

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

Path parameters

chainId*string

Example: "solana"

tokenAddress*string

Example: "A55XjvzRU4KtR3Lrys8PpLZQvPojPqvnv5bJVHMYy3Jv"

Response

200

Ok

Body

application/json

typeenum

tokenProfilecommunityTakeovertokenAdtrendingBarAd

statusenum

processingcancelledon-holdapprovedrejected

paymentTimestampnumber

Request

JavaScriptCurlPython

const response = await fetch('https://api.dexscreener.com/orders/v1/{chainId}/{tokenAddress}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

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

Get one or multiple pairs by chain and pair address (rate-limit 300 requests per minute)

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

Path parameters

chainId*string

Example: "solana"

pairId*string

Example: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"

Response

200

Ok

Body

application/json

schemaVersionstring

pairsnullable array of Pair (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.dexscreener.com/latest/dex/pairs/{chainId}/{pairId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "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",
      "liquidity": {
        "usd": 0,
        "base": 0,
        "quote": 0
      },
      "fdv": 0,
      "marketCap": 0,
      "pairCreatedAt": 0,
      "info": {
        "imageUrl": "https://example.com",
        "websites": [
          {
            "url": "https://example.com"
          }
        ],
        "socials": [
          {
            "platform": "text",
            "handle": "text"
          }
        ]
      },
      "boosts": {
        "active": 0
      }
    }
  ]
}

Search for pairs matching query (rate-limit 300 requests per minute)

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

Query parameters

Response

200

Ok

Body

application/json

schemaVersionstring

pairsarray of Pair (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.dexscreener.com/latest/dex/search?q=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "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",
      "liquidity": {
        "usd": 0,
        "base": 0,
        "quote": 0
      },
      "fdv": 0,
      "marketCap": 0,
      "pairCreatedAt": 0,
      "info": {
        "imageUrl": "https://example.com",
        "websites": [
          {
            "url": "https://example.com"
          }
        ],
        "socials": [
          {
            "platform": "text",
            "handle": "text"
          }
        ]
      },
      "boosts": {
        "active": 0
      }
    }
  ]
}

Get the pools of a given token address (rate-limit 300 requests per minute)

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

Path parameters

chainId*string

Example: "solana"

tokenAddress*string

A token addresses

Example: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"

Response

200

Ok

Body

application/json

chainIdstring

dexIdstring

urlstring (uri)

pairAddressstring

labelsnullable array of string

baseTokenobject

quoteTokenobject

priceNativestring

priceUsdnullable string

txnsobject

volumeobject

priceChangenullable object

liquiditynullable object

fdvnullable number

marketCapnullable number

pairCreatedAtnullable integer

infoobject

boostsobject

Request

JavaScriptCurlPython

const response = await fetch('https://api.dexscreener.com/token-pairs/v1/{chainId}/{tokenAddress}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "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",
    "liquidity": {
      "usd": 0,
      "base": 0,
      "quote": 0
    },
    "fdv": 0,
    "marketCap": 0,
    "pairCreatedAt": 0,
    "info": {
      "imageUrl": "https://example.com",
      "websites": [
        {
          "url": "https://example.com"
        }
      ],
      "socials": [
        {
          "platform": "text",
          "handle": "text"
        }
      ]
    },
    "boosts": {
      "active": 0
    }
  }
]

Get one or multiple pairs by token address (rate-limit 300 requests per minute)

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

Path parameters

chainId*string

Example: "solana"

tokenAddresses*string

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

Example: "So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

Response

200

Ok

Body

application/json

chainIdstring

dexIdstring

urlstring (uri)

pairAddressstring

labelsnullable array of string

baseTokenobject

quoteTokenobject

priceNativestring

priceUsdnullable string

txnsobject

volumeobject

priceChangenullable object

liquiditynullable object

fdvnullable number

marketCapnullable number

pairCreatedAtnullable integer

infoobject

boostsobject

Request

JavaScriptCurlPython

const response = await fetch('https://api.dexscreener.com/tokens/v1/{chainId}/{tokenAddresses}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "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",
    "liquidity": {
      "usd": 0,
      "base": 0,
      "quote": 0
    },
    "fdv": 0,
    "marketCap": 0,
    "pairCreatedAt": 0,
    "info": {
      "imageUrl": "https://example.com",
      "websites": [
        {
          "url": "https://example.com"
        }
      ],
      "socials": [
        {
          "platform": "text",
          "handle": "text"
        }
      ]
    },
    "boosts": {
      "active": 0
    }
  }
]