DEX search

GET https://open-api.coinworldcap.com/openapi/v1/dex/search

DEX tokens whose address, symbol or name match a query, from the published lists.

Query parameters

qstringDefaultrequired2 to 64 characters once surrounding whitespace is trimmed, counted as characters, not bytes. An address longer than 64 characters (some Sui addresses) cannot be matched exactly; search its symbol or name
limitintegerDefault10At most 20; 0 or below is 10

Response

Not paged; items is [] when nothing matches. Matching ignores case (except an address that is not 0x with 40 hexadecimal digits, on a token no list holds any more), and the hits come in three groups — the address equal to q, then a symbol starting with q, then a name containing q — each by liquidity, highest first, null last. A token in several lists is one hit. When the lists give fewer than limit hits, tokens no list holds any more follow, matched by address and symbol only, never by name, with lists: [].

Field	Type	Notes
`id`, `chain_slug`, `address`, `symbol`, `name`, `logo`	string	As on `/dex/tokens`; pass `chain_slug` and `address` to `/dex/tokens/info`
`price`, `liquidity`	string or `null`	USD
`percent_change`	object	The key `24h` only
`lists`	array	The lists holding the token, in the order `trending`, `new`, `gainers`; `[]` for a token no list holds now

Examples

bash

# Tokens matching "pepe"
curl -H "X-Api-Key: <your-api-key>" \
  "https://open-api.coinworldcap.com/openapi/v1/dex/search?q=pepe"

# By contract address
curl -H "X-Api-Key: <your-api-key>" \
  "https://open-api.coinworldcap.com/openapi/v1/dex/search?q=0x07b3d902783c3c12b077508c3b5c00113d1291d0&limit=5"

HTTP status	`code`	When
400	40000	`q` missing, or shorter than 2 or longer than 64 characters; `limit` above 20 or not an integer
503	50300	No Trending list younger than three hours

The other errors are in Errors.

# Tokens matching "pepe" import requests response = requests.get( "https://open-api.coinworldcap.com/openapi/v1/dex/search?q=pepe", headers={"X-Api-Key": "<your-api-key>"}, ) print(response.json())

// Tokens matching "pepe" fetch("https://open-api.coinworldcap.com/openapi/v1/dex/search?q=pepe", { headers: { "X-Api-Key": "<your-api-key>" }, }) .then((response) => response.json()) .then((body) => console.log(body));

// Tokens matching "pepe" package main import ( "fmt" "io" "net/http" ) func main() { req, err := http.NewRequest(http.MethodGet, "https://open-api.coinworldcap.com/openapi/v1/dex/search?q=pepe", nil) if err != nil { panic(err) } req.Header.Set("X-Api-Key", "<your-api-key>") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

// Tokens matching "pepe" import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class Main { public static void main(String[] args) throws Exception { HttpRequest request = HttpRequest.newBuilder(URI.create("https://open-api.coinworldcap.com/openapi/v1/dex/search?q=pepe")) .header("X-Api-Key", "<your-api-key>") .GET() .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

{ "code": 0, "message": "success", "message_key": "SUCCESS", "result": { "items": [ { "id": "1", "chain_slug": "base", "address": "0x07b3d902783c3c12b077508c3b5c00113d1291d0", "symbol": "XDP", "name": "Doppler", "logo": "https://s2.coinmarketcap.com/static/img/coins/64x64/40953.png", "price": "0.0204910145", "liquidity": "4238562.5", "percent_change": { "24h": "2.31" }, "lists": ["trending"] } ] } }