Submit a Delta Order

Submit Delta Order for Auction

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

The Submit Delta Order for Auction endpoint allows you to submit a Delta order to be auctioned on Velora Delta. This enables decentralized and efficient execution of large token swaps through the Delta smart contract.

By sending a properly formatted request, you can specify order details such as the source and destination tokens, amounts, deadline, and additional parameters required for execution.

Use this endpoint to initiate a Delta auction order and optimize your trade execution on the Velora Delta network.

Request Body Params

Name
Type
Description

order*

Order

The built order to be submitted.

signature*

string

Signature of the order from order.owner address. EOA signatures must be submitted in ERC-2098 Compact Representation.

chainId*

string

Chain ID. (Mainnet - 1, Optimism - 10, BSC - 56, Polygon - 137, Fantom - 250, zkEVM - 1101, Base - 8453, Arbitrum - 42161, Avalanche - 43114, Gnosis - 100).

partiallyFillable

boolean

Allow the order to be filled in parts. Default: false

partner

string

Partner string.

includeAgents

string[]

List of agent names to include. If not provided, all the agents are included

excludeAgents

string[]

List of agent names to exclude. If not provided, none of the agents are excluded

referrerAddress

string

Referrer address

Example Responses:

The first example response indicates a successful order submission because it includes an id, orderHash, status, and other relevant order details. The status is "NOT_STARTED", meaning the order has been created but not yet processed.

The second response, { "error": "Validation failed with error" }, indicates a failed submission due to a validation issue, likely caused by missing or incorrect parameters in the request.

{
  "id": "c964ef14-4ab6-4a54-a946-cbeca04c86bc",
  "deltaVersion": "2.0",
  "user": "0x75c94990d2ad92d8da4e0a238d872d09ec16706e",
  "signature": "0xefabafd33ac5ca787b97338414cd24446ec2924e4a1844b9f433135f5c42aacf38cfd12251401e9ecb9389149ac019d7c8b3de45ffa169c3496fa8289626c4f9",
  "status": "NOT_STARTED",
  "bridgeStatus": null,
  "order": {
    "owner": "0x75c94990d2ad92d8da4e0a238d872d09ec16706e",
    "beneficiary": "0x75c94990d2ad92d8da4e0a238d872d09ec16706e",
    "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"
    }
  },
  "bridgeMetadata": null,
  "orderVersion": "2.0.0",
  "orderHash": "0x26064c676c6cad53b67de117255cfad5386629a00d6acf0dffe896abcb590c6b",
  "partiallyFillable": false,
  "chainId": 8453,
  "partner": "paraswap.io",
  "referrerAddress": null,
  "includeAgents": null,
  "excludeAgents": null,
  "deltaGasOverhead": 168446,
  "expiresAt": "2025-04-24T08:34:31.000Z",
  "createdAt": "2025-04-24T07:35:13.594Z",
  "updatedAt": "2025-04-24T07:35:13.594Z"
}

Last updated