getSwapTrades

import requests
url = "https://api.0x.org/trade-analytics/swap"
querystring = {"cursor":"eyJ0aW1lc3RhbXAiOjE3MjkwMzIyMTAsInppZCI6IjB4N2FjM2NlMzExNjA2NzU5MGY5M2U3MWVmIn0=","startTimestamp":"1729032210","endTimestamp":"1729032211"}
headers = {
    "0x-api-key": "0x-api-key",
    "0x-version": "v2"
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

{
  "nextCursor": null,
  "trades": [
    {
      "appName": "Example app",
      "blockNumber": "123456",
      "buyToken": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
      "buyAmount": "0.0512",
      "chainId": 1,
      "chainName": "string",
      "fees": {
        "integratorFee": null,
        "zeroExFee": null
      },
      "gasUsed": "141111",
      "protocolVersion": "Settler",
      "sellToken": "0x4d1c297d39c5c1277964d0e3f8aqqqq493664530",
      "sellAmount": "123.111",
      "slippageBps": "1",
      "taker": "0x23f2ad8e04dfdc0000a3e80891e3ae43f322000a",
      "timestamp": 1777772227,
      "tokens": [
        {
          "address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
          "symbol": "ETH"
        },
        {
          "address": "0xaaaaaaaaaaaaaa277964d0e3f8aa901493664530",
          "symbol": "TKN"
        }
      ],
      "transactionHash": "0x42bad789ddd64aaaaaaaaaaaceb795063f5623558f130e0f4d30ad399b041411",
      "volumeUsd": "139.73",
      "zid": "0x04baaaaaaa1f1af0304eb412",
      "service": "swap"
    }
  ],
  "zid": "0xaaaaaae1b3bf43f082d5012d"
}

Get the list of completed swap trades. Returns a maximum of 200 trades per request. Visit here for more details about how the API works.

Query parameters

cursorstringOptional

A pagination cursor used to fetch the next page of trades. It should be set to null for the initial request; otherwise, it should be the value of nextCursor that is returned from getSwapTrades or getGaslessTrades calls.

startTimestampintegerOptional>=0

Unix timestamp in seconds, specifying the starting point of the time range filter. Only trades completed on or after this timestamp will be included in the response.

endTimestampintegerOptional>=0

Unix timestamp in seconds, specifying the end point of the time range filter. Only trades completed on or before this timestamp will be included in the response.

Response

Successful response

nextCursorstring or null

The cursor to fetch the next page of trades. If not present, there are no more trades to fetch for given parameters.

tradeslist of objects

zidstring

The unique ZeroEx identifier of the request

Headers

Query parameters

Response

Errors