Get list of DEX protocols

Professional This endpoint requires the professional plan or higher

Get a list of DEX (Decentralized Exchange) protocols. DEX protocols are child exchanges that are part of a parent DEX exchange. They are ranked based on their trading volume in the last 24 hours.

https://api.coinranking.com/v2/dex-protocols

Query parameters

Parameter Description
referenceCurrencyUuid (optional) String

UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint

Default value: yhjMzLPhuIDl

Example:
...dex-protocols?referenceCurrencyUuid=5k-_VTxqtCEI
limit (optional) Number

Limit. Used for pagination. Only usable when no filters are applied. The maximum amount of results you can fetch in one request is 5000 for the Startup and Professional plan, and 100 for the Free plan.

Default value: 50
Size range: 0-5000


Example:
...dex-protocols?limit=10
offset (optional) Number

Offset. Used for pagination.

Default value: 0

Example:
...dex-protocols?offset=50
orderBy (optional) String

Order by either 24h volume, number of markets or latest ticker. Ordering can only be done when no filters are applied.

Default value: 24hVolume
Allowed values:
24hVolume numberOfMarkets lastTickerCreatedAt

Example:
...dex-protocols?orderBy=24hVolume
orderDirection (optional) String

Applies direction to the orderBy query, which can be in ascending or descending order. Only usable when no filters are applied.

Default value: desc
Allowed values:
desc asc

Example:
...dex-protocols?orderDirection=asc
uuids (optional) Array

DEX Protocol UUIDs to filter the protocols on.

Example:
...dex-protocols?uuids[]=5Sfs67ZcuOWm&uuids[]=oIbmZCdhy
search (optional) String

Value to search for within results, e.g. protocol names.

Example:
...dex-protocols?search=uniswap
countries (optional) Array

Filter DEX protocols by supported countries using ISO 3166-1 alpha-2 country codes. Returns only protocols that support trading in at least one of the specified countries. See the country codes reference for a full list of supported codes.

Example:
...dex-protocols?countries[]=US&countries[]=GB
fiatCurrencyUuids (optional) Array

Filter DEX protocols by fiat currencies they support for trading pairs, using each currency's UUID. Returns only protocols that support at least one of the specified fiat currencies. You can find fiat currency UUIDs in the reference currencies endpoint using ?types[]=fiat.

Single value example:
...dex-protocols?fiatCurrencyUuids[]=yhjMzLPhuIDl
Multiple values example:
...dex-protocols?fiatCurrencyUuids[]=yhjMzLPhuIDl&fiatCurrencyUuids[]=5k-_VTxqtCEI

Code examples

Response

json
HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "stats": {
      "24hVolume": "111955679139",
      "total": 59
    },
    "exchanges": [
      {
        "uuid": "oIbmZCdhy",
        "name": "PancakeSwap v3 (BSC)",
        "iconUrl": "https://cdn.coinranking.com/3wigw7gEZ/pancakeswap.png",
        "verified": false,
        "recommended": true,
        "numberOfMarkets": 789,
        "numberOfCoins": 526,
        "marketShare": "11.37",
        "24hVolume": "38330704543"
      },
      {
        "uuid": "FeCJqGOi1",
        "name": "Uniswap v3 (Ethereum)",
        "iconUrl": "https://cdn.coinranking.com/j-19SX5s-/7083.png",
        "verified": false,
        "recommended": true,
        "numberOfMarkets": 675,
        "numberOfCoins": 412,
        "marketShare": "8.01",
        "24hVolume": "26984105104"
      }
    ]
  }
}

Response fields

PropertyDescription
status String

Status of the request

Allowed values:
success
data Object
data.stats Object
data.stats.24hVolume String

Total 24h volume of DEX protocols in the reference currency

data.stats.total Number

Total number of DEX protocols

data.exchanges Object[]

List of DEX protocols (child exchanges)

data.exchanges.uuid String

UUID of the DEX protocol

data.exchanges.name String

Name of the DEX protocol

data.exchanges.iconUrl String

Location of the icon

data.exchanges.verified Boolean

DEPRECATED DEX protocols that are verified to not participate in harmful practices such as wash trading are marked as verified.

data.exchanges.recommended Boolean

Whether the DEX protocol is recommended based on our criteria, see https://support.coinranking.com/article/82-recommended-exchanges

data.exchanges.numberOfMarkets Number

Number of markets of the DEX protocol paired with Coinranking

data.exchanges.numberOfCoins Number

Number of coins of the DEX protocol paired with Coinranking

data.exchanges.24hVolume String

Total volume in 24 hours

data.exchanges.marketShare String

Percentage of the total DEX protocol volume represented by this protocol.

Error response

json
HTTP/1.1 422 Unprocessable Entity
{
  "status": "fail",
  "type": "REFERENCE_UNAVAILABLE",
  "message": "Reference currency not available"
}

Error responses

Previous

DEXs

 Next

DEX details

On this page