DEX token holders

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

One DEX token's largest holders, and how many it has.

Query parameters

chain_slug, addressstringDefaultrequiredSee naming a token

Response

Not paged: up to 100 holders, largest first, as the source ranks them. The source refreshes the snapshot every 15 minutes to an hour, less often for quiet tokens; a snapshot expires 24 hours after it was last written, and the tab then answers available: false.

Field	Type	Notes
`available`, `data_time`		As on `/dex/tokens/trades`
`stale`	boolean	Last refreshed more than 12 hours ago
`holders_count`	number or `null`	How many wallets hold the token: the snapshot's count, else the list's; `null` when neither has one. Served whether or not `available`
`items[].rank`	number	1 is the largest
`items[].wallet_address`	string
`items[].balance`	string or `null`	In the token's units
`items[].percent`	string or `null`	Share of the supply, in percent (`"12.5"` is 12.5%)
`items[].tags`	array	Labels on the wallet; may be empty
`items[].first_active_time`	string or `null`	RFC3339

Examples

bash

curl -H "X-Api-Key: <your-api-key>" \
  "https://open-api.coinworldcap.com/openapi/v1/dex/tokens/holders?chain_slug=base&address=0x07b3d902783c3c12b077508c3b5c00113d1291d0"

HTTP status	`code`	When
400	40000	`chain_slug` or `address` missing
404	40400	The token, as on `/dex/tokens/info`
503	50300	No Trending list younger than three hours; reading the holders, or a token no list holds, timed out (retryable)
500	50000	Reading the holders failed for another reason

The other errors are in Errors.

import requests response = requests.get( "https://open-api.coinworldcap.com/openapi/v1/dex/tokens/holders?chain_slug=base&address=0x07b3d902783c3c12b077508c3b5c00113d1291d0", headers={"X-Api-Key": "<your-api-key>"}, ) print(response.json())

fetch("https://open-api.coinworldcap.com/openapi/v1/dex/tokens/holders?chain_slug=base&address=0x07b3d902783c3c12b077508c3b5c00113d1291d0", { headers: { "X-Api-Key": "<your-api-key>" }, }) .then((response) => response.json()) .then((body) => console.log(body));

package main import ( "fmt" "io" "net/http" ) func main() { req, err := http.NewRequest(http.MethodGet, "https://open-api.coinworldcap.com/openapi/v1/dex/tokens/holders?chain_slug=base&address=0x07b3d902783c3c12b077508c3b5c00113d1291d0", 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)) }

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/tokens/holders?chain_slug=base&address=0x07b3d902783c3c12b077508c3b5c00113d1291d0")) .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": { "available": true, "data_time": "2026-10-21T07:00:00Z", "stale": false, "holders_count": 18234, "items": [ { "rank": 1, "wallet_address": "0x4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e", "balance": "125000000.5", "percent": "12.5", "tags": ["lp"], "first_active_time": "2026-08-26T19:33:20Z" } ] } }