VeloraUser Documentation

Track Delta Order Auction Status

Get Delta Order Auction Status

GET https://api.paraswap.io/delta/orders/:orderId

This endpoint enables users to retrieve real-time details of a specific auction, ensuring transparency and efficient execution monitoring.

{
  "id": "c964ef14-4ab6-4a54-a946-cbeca04c86bc",
  "deltaVersion": "2.0",
  "status": "EXECUTED",
  "user": "0xb0326588271f2531fbfc9a13d52d3da45be1d956",
  "order": {
    "owner": "0xb0326588271f2531fbfc9a13d52d3da45be1d956",
    "beneficiary": "0xb0326588271f2531fbfc9a13d52d3da45be1d956",
    "srcToken": "0x4158734d47fc9692176b5085e0f52ee0da5d47f1",
    "destToken": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
    "srcAmount": "7402648515419564534",
    "destAmount": "6803821",
    "expectedDestAmount": "6838012",
    "deadline": 1745483671,
    "nonce": "1745480091818",
    "partnerAndFee": "90631063861114836560958097440945986548822432573276877133894239693005947666432",
    "permit": "0x",
    "bridge": {
      "maxRelayerFee": "582570",
      "destinationChainId": 1,
      "outputToken": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "multiCallHandler": "0x0000000000000000000000000000000000000000"
    }
  },
  "orderHash": "0x26064c676c6cad53b67de117255cfad5386629a00d6acf0dffe896abcb590c6b",
  "chainId": 8453,
  "partner": "paraswap.io",
  "expiresAt": "2025-04-24T08:34:31.000Z",
  "createdAt": "2025-04-24T07:35:13.594Z",
  "updatedAt": "2025-04-24T07:36:04.735Z",
  "partiallyFillable": false,
  "includeAgents": null,
  "excludeAgents": null,
  "bridgeMetadata": {
    "depositId": 3716967,
    "fillDeadline": 1745491811,
    "outputAmount": "6551680",
    "fillTx": "0x2866e2ece74b8dda04daf1816988e37e18c1811e6a2bf4e379b1824d44078ca2"
  },
  "bridgeStatus": "filled",
  "referrerAddress": null,
  "transactions": [
    {
      "id": "13d80642-494c-4c4b-858e-851216d95f77",
      "hash": "0x79083f0c82aab2c491ca96cd9f6d3e0de7a91fcb6644c9e68b7a44c77386f7be",
      "blockNumber": 29345390,
      "blockHash": "0x5b23e1f1ce22b568f85b44a2af08834975d026e50c41e564a61abbe0eec6b43c",
      "gasUsed": 457650,
      "gasPrice": 2285199,
      "blobGasUsed": 0,
      "blobGasPrice": 0,
      "index": 97,
      "status": 1,
      "from": "0x2e5ef37ade8afb712b8be858fec7389fe32857e2",
      "to": "0x0000000000bbf5c5fd284e657f01bd000933c96d",
      "receivedAmount": "6838489",
      "receivedAmountUSD": 6.84,
      "spentAmount": "7402648515419564534",
      "spentAmountUSD": 7.09,
      "filledPercent": 10000,
      "protocolFee": "477",
      "partnerFee": "0",
      "agent": "laita",
      "orderId": "c964ef14-4ab6-4a54-a946-cbeca04c86bc",
      "bidId": "74ac549f-1450-42dd-9f98-ec1a02629689"
    }
  ]
}

Available order statuses (status property)

Status
Description

NOT_STARTED

The initial state of an order when it enters the system. Orders in this state are waiting to be included in a batch auction. Orders that failed execution may also be reset to this state to retry.

RUNNING

Orders that are actively being considered for execution in the current batch auction.

EXECUTING

Orders that have been assigned to a winning agent who has been notified to execute them. This status indicates that on-chain execution is in progress. Orders remain in this state untiltransaction confirmation or timeout.

INSUFFICIENT_BALANCE

This state indicates that an order has insufficient token balance during secondary validation. This happens when a user's token balance drops below the required amount after the initial validation. Since this is a non-terminal status, the system will periodically recheck the balance, allowing the order to proceed to auction if the user adds sufficient funds.

INSUFFICIENT_ALLOWANCE

This state indicates that an order has insufficient token allowance during secondary validation. This occurs when a user's approval for the Delta contract is reduced or revoked after initial validation. Since this is a non-terminal status, the system will periodically recheck the allowance, allowing the order to proceed if the user reinstates or increases the approval.

INVALIDATED

A terminal status indicating that an order has failed secondary validation before being included in an auction. This happens when orders undergo re-validation after initial posting but before auction inclusion. Orders may be invalidated due to changed conditions since initial validation, for example nonce was invalidated because other order with the same nonce has already been executed.

EXECUTED

A terminal state indicating that the order has been successfully executed on-chain.

FAILED

A terminal state indicating that the order failed execution after multiple retry attempts.

EXPIRED

A terminal state indicating that the order's deadline has passed without successful execution.

Available bridge statuses (bridgeStatus property, set only for cross-chain orders, null for same-chain orders).

status
Description

PENDING

The initial status for a bridged order after execution on the source chain. Indicates that the transaction has been successfully executed on the source chain, but hasn't been bridged yet.

FILLED

A terminal state indicating that the order has been filled on the destination chain. fillTx property in bridgeMetadata becomes available.

REFUNDED

A terminal state indicating that the order has been refunded on the source chain. The refunded token would be the one that was sent to bridge after the swap. depositRefundTxHash property in bridgeMetadata becomes available.

Get Delta Orders for a User

GET https://api.paraswap.io/delta/orders

The Get Delta Orders for a User endpoint allows integrators to fetch all orders associated with a specific address, making it invaluable for dashboards, trade history tracking, and compliance purposes.

Query Parameters

Name
Type
Description

userAddress*

string

User Address.

chainId

string

Filters orders by Chain ID.

page

integer

Default: 1.

limit

integer

Default: 100.

[
  {
    "id": "bcd4c543-171c-4057-ae16-f19b340ef783",
    "deltaVersion": "2.0",
    "user": "0x75c94990d2ad92d8da4e0a238d872d09ec16706e",
    "status": "EXECUTED",
    "order": {
      "owner": "0x75c94990d2ad92d8da4e0a238d872d09ec16706e",
      "beneficiary": "0x0000000000000000000000000000000000000000",
      "srcToken": "0x50c5725949a6f0c72e6c4a641f24049a917db0cb",
      "destToken": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "srcAmount": "3000000000000000000",
      "destAmount": "2697006",
      "expectedDestAmount": "2996674",
      "deadline": 1745315885,
      "nonce": "47134762539353625094565801522442644172557927090371905496621550987541735363889",
      "partnerAndFee": "0",
      "permit": "0x",
      "bridge": {
        "maxRelayerFee": "0",
        "destinationChainId": 0,
        "outputToken": "0x0000000000000000000000000000000000000000",
        "multiCallHandler": "0x0000000000000000000000000000000000000000"
      }
    },
    "partiallyFillable": false,
    "orderHash": "0xc3d58decc6405c11a66828622ab300aa569c14ff93473c83049b682de80fafd8",
    "chainId": 8453,
    "partner": "anon",
    "expiresAt": "2025-04-22T09:58:05.000Z",
    "createdAt": "2025-04-22T08:58:09.105Z",
    "updatedAt": "2025-04-22T09:00:40.327Z",
    "includeAgents": null,
    "excludeAgents": null,
    "bridgeMetadata": null,
    "bridgeStatus": null,
    "referrerAddress": null,
    "transactions": [
      {
        "id": "65c9ed25-daaa-47c4-b18d-38886b87d7e4",
        "hash": "0xabbdf44072995a4093ce0d5fb35c9d678e97180c03254a47078b617b777fa8e6",
        "blockNumber": 29261546,
        "blockHash": "0xe13d9d046f6267e2c9e7e9c6a480ea50bb6eef18279e8ae26ab71db08e544578",
        "gasUsed": 254114,
        "gasPrice": 2939401,
        "blobGasUsed": 0,
        "blobGasPrice": 0,
        "index": 26,
        "status": 1,
        "from": "0x2e5ef37ade8afb712b8be858fec7389fe32857e2",
        "to": "0x0000000000bbf5c5fd284e657f01bd000933c96d",
        "receivedAmount": "2996890",
        "receivedAmountUSD": 3,
        "spentAmount": "3000000000000000000",
        "spentAmountUSD": 3,
        "filledPercent": 10000,
        "protocolFee": "215",
        "partnerFee": "0",
        "agent": "laita",
        "orderId": "bcd4c543-171c-4057-ae16-f19b340ef783",
        "bidId": "596b77a4-f47a-4c4c-b8c4-b1f5f2d1c856"
      }
    ]
  },
  {
    "id": "68fd78b6-d041-4266-81b0-6699f4c1288b",
    "deltaVersion": "2.0",
    "user": "0x75c94990d2ad92d8da4e0a238d872d09ec16706e",
    "status": "EXECUTED",
    "order": {
      "owner": "0x75c94990d2ad92d8da4e0a238d872d09ec16706e",
      "beneficiary": "0x75c94990d2ad92d8da4e0a238d872d09ec16706e",
      "srcToken": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "destToken": "0x50c5725949a6f0c72e6c4a641f24049a917db0cb",
      "srcAmount": "5000000",
      "destAmount": "4976463718951395041",
      "expectedDestAmount": "5001471074323010092",
      "deadline": 1744964308,
      "nonce": "1744960709953",
      "partnerAndFee": "20974155095831688201008782508213971467846289911829368236151719561677686964224",
      "permit": "0x",
      "bridge": {
        "maxRelayerFee": "376123157833491748",
        "destinationChainId": 1,
        "outputToken": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "multiCallHandler": "0x0000000000000000000000000000000000000000"
      }
    },
    "partiallyFillable": false,
    "orderHash": "0x714e97c6fca6f8002fc5c5078d6bbfa47e0a7dceed0255385bb395ced18c3c37",
    "chainId": 8453,
    "partner": "paraswap.io-staging",
    "expiresAt": "2025-04-18T08:18:28.000Z",
    "createdAt": "2025-04-18T07:18:37.539Z",
    "updatedAt": "2025-04-18T07:20:00.217Z",
    "includeAgents": null,
    "excludeAgents": null,
    "bridgeMetadata": {
      "depositId": 3682857,
      "fillDeadline": 1744972427,
      "outputAmount": "4816077562272480962",
      "fillTx": "0xd33dbce82917ababa7297e44cead71c1eac8bd8dc5f723bc48b3a81f55032df7"
    },
    "bridgeStatus": "filled",
    "referrerAddress": null,
    "transactions": [
      {
        "id": "9ffd626a-c2cc-443d-94ee-e635c1422fe9",
        "hash": "0x0a0cf74d7e8039563ee21bc93d671d968fc87fe7f382647350eca659209abe56",
        "blockNumber": 29085695,
        "blockHash": "0xf866d3c775ca0703767e5bb10c3990f796b8718460fb682ba8275bfbed1d376c",
        "gasUsed": 284411,
        "gasPrice": 2213099,
        "blobGasUsed": 0,
        "blobGasPrice": 0,
        "index": 56,
        "status": 1,
        "from": "0x2e5ef37ade8afb712b8be858fec7389fe32857e2",
        "to": "0x0000000000bbf5c5fd284e657f01bd000933c96d",
        "receivedAmount": "5001294592878301750",
        "receivedAmountUSD": 5,
        "spentAmount": "5000000",
        "spentAmountUSD": 5,
        "filledPercent": 10000,
        "protocolFee": "0",
        "partnerFee": "0",
        "agent": "laita",
        "orderId": "68fd78b6-d041-4266-81b0-6699f4c1288b",
        "bidId": "89a42b15-95a8-499c-8b1b-bf9a09c8b05d"
      }
    ]
  }
]

Most common error messages

These are the two most common messages when using this endpoint.

  • ValidationError - validation for params failed

  • UnsupportedChain - the chain ID is not supported by Delta.

To avoid running into ValidationError and UnsupportedChain errors when using this endpoint, here are some recommendations:

Avoiding ValidationError

  1. Check Required Parameters: Ensure all mandatory parameters are included in your request. Missing or incorrectly formatted fields often trigger this error.

  2. Validate Data Types: Confirm that parameters match the expected types (e.g., numbers vs. strings, correct JSON structure).

  3. Follow API Documentation: Double-check the expected format for each parameter in the official API documentation.

Avoiding UnsupportedChain

  1. Verify Supported Chains: Check the API documentation or a dedicated "supported chains" endpoint to ensure the chain ID is compatible with Delta.

  2. Use Correct Chain IDs: Some APIs require chain IDs in decimal format, while others expect hex. Ensure you’re using the correct format.

Last updated