DCA Order Executions v0 API

Overview#

This endpoint retrieves the execution history of a specific Dollar-Cost Averaging (DCA) order identified by its orderID. This endpoint provides simplified information on all executions related to the given order, including amounts and transaction hash.

Endpoint#

https://api.swapscanner.io/v0/dca/order/[orderID]/executions

Path Parameters#

• orderID (required): A valid order ID in the format of a 64-character hexadecimal string prefixed with 0x. For example: 0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef.

Response Structure#

The endpoint returns a JSON object with the following properties:

• executions (array): A list of execution records, sorted by timestamp, with the following fields:
  • index (number): The index of the execution in the list.
  • transactionHash (string): The transaction hash of the execution.
  • amountIn (string): The amount of tokens sent in the execution.
  • amountOut (string): The amount of tokens received in the execution.
  • timestamp (number): The timestamp of the execution in milliseconds since the UNIX epoch.

Example#

{
  "executions": [
    {
      "index": 0,
      "transactionHash": "0x7fe9ca3fb4a23555c30683f378fe236a84f9d33b7cd65d75144cda8059cd07f9",
      "amountIn": "36000000",
      "amountOut": "71843331577023258289",
      "timestamp": 1733038355000
    },
    {
      "index": 1,
      "transactionHash": "0x6784dbb4a0882f0be0efb9ca6773d44f52867db898005ac10029da8c9a06901d",
      "amountIn": "36000000",
      "amountOut": "73393911233669959472",
      "timestamp": 1733052800000
    },
    {
      "index": 2,
      "transactionHash": "0x5fc6c5b37499376566adce83b6176de299e7299d3298a72e0db4c840b8826329",
      "amountIn": "36000000",
      "amountOut": "72341114062482189268",
      "timestamp": 1733067291000
    }
  ]
}

Error Responses#

• 400 Bad Request: The orderID parameter is missing or invalid.
• 429 Too Many Requests: Rate limit exceeded.
• 500 Internal Server Error: Unexpected server error.

Notes#

• The executions list is sorted chronologically by timestamp.