DEX token trades

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

One DEX token's recent trades, newest first, a page at a time. Only the last 48 hours, and at most 100 trades, are served.

Query parameters

chain_slug, addressstringDefaultrequiredSee naming a token
limitintegerDefault20At most 100; 0 or below is 20
cursorstringDefaultthe first pageThe next_cursor of the page before, passed back as it came

Response

Order and paging. The array is newest first. tx_time is to the second, and within one second the array's order is the only order we give, so page by next_cursor, never by time: pass it back as cursor until it is null. Pass a cursor back only to the token and tab that issued it — that is the paging we promise; a cursor that is not in the form we issue is a 400.

Field	Type	Notes
`available`	boolean	`false` when we do not collect this token's trades — not an error, and retrying soon will not change it; `items` is then `[]`
`data_time`	string	When the trades were last refreshed. When `available` is `false`, the token's `data_time` as on `/dex/tokens/info`: when the list that supplied it was built, or when a token no list holds was last listed
`stale`	boolean	Last refreshed more than 30 minutes ago. When `available` is `false`, the token's `stale` as on `/dex/tokens/info` (always `false` for a token no list holds)
`window_limit`	object	`hours` and `max`: how far back the trades reach and how many are kept
`last_trade_time`	string or `null`	The newest trade we have seen for the token, whether or not `available`
`items[].id`	string	Unique within the token. One transaction can hold several trades, so `tx_hash` repeats and `id` does not
`items[].tx_time`	string	RFC3339, to the second
`items[].tx_type`	string	`buy` or `sell`, of the token asked for
`items[].price`	string or `null`	USD
`items[].base_amount`, `items[].quote_amount`	string or `null`	Token amounts: `base` is the token asked for, `quote` the other side of the pool
`items[].value`	string or `null`	The trade's value in USD
`items[].base_symbol`, `items[].quote_symbol`, `items[].exchange_name`	string or `null`
`items[].maker`	string or `null`	The trader's wallet
`items[].tx_hash`	string
`items[].holder_tags`	array	Labels on the trader's wallet; may be empty
`next_cursor`	string or `null`	`null` when nothing older is in the window

available can be true with no items: the token is tracked and had no trade in the window.

Examples

bash

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

# The next page
curl -H "X-Api-Key: <your-api-key>" \
  "https://open-api.coinworldcap.com/openapi/v1/dex/tokens/trades?chain_slug=base&address=0x07b3d902783c3c12b077508c3b5c00113d1291d0&limit=20&cursor=<next_cursor>"

HTTP status	`code`	When
400	40000	`chain_slug` or `address` missing; `limit` above 100 or not an integer; a `cursor` not in the form we issue
404	40400	The token, as on `/dex/tokens/info`
503	50300	No Trending list younger than three hours; reading the trades, or a token no list holds, timed out (retryable)
500	50000	Reading the trades failed for another reason

The other errors are in Errors.

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

fetch("https://open-api.coinworldcap.com/openapi/v1/dex/tokens/trades?chain_slug=base&address=0x07b3d902783c3c12b077508c3b5c00113d1291d0&limit=20", { 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/trades?chain_slug=base&address=0x07b3d902783c3c12b077508c3b5c00113d1291d0&limit=20", 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/trades?chain_slug=base&address=0x07b3d902783c3c12b077508c3b5c00113d1291d0&limit=20")) .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-21T08:05:00Z", "stale": false, "window_limit": { "hours": 48, "max": 100 }, "last_trade_time": "2026-10-21T08:04:00Z", "items": [ { "id": "0x5e2c7a1f3b9d4e8a6c0f2b7d9e1a3c5f7b9d2e4a6c8f0b1d3e5a7c9f1b3d5e7a:2", "tx_time": "2026-10-21T08:04:00Z", "tx_type": "buy", "price": "0.0204910145", "base_amount": "48800.5", "base_symbol": "XDP", "quote_amount": "0.2857", "quote_symbol": "WETH", "value": "1000.12", "exchange_name": "Uniswap V3", "maker": "0x1f2e3d4c5b6a79880716253443526170f8e9d0c1", "tx_hash": "0x5e2c7a1f3b9d4e8a6c0f2b7d9e1a3c5f7b9d2e4a6c8f0b1d3e5a7c9f1b3d5e7a", "holder_tags": ["whale"] } ], "next_cursor": "MTc5MTE4MjY0MDAwMDow…" } }