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).

type

MARKET | LIMIT

Indicates order type. Defaults to MARKET. Used for filtering only

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": "57165af8-eee8-408e-b8e8-86cc7f5c9f5c",
  "auctionOrderId": "e4579d19-e4b9-4fa1-87f3-edcf6c002a3b",
  "deltaVersion": "2.0",
  "user": "0xb0326588271f2531fbfc9a13d52d3da45be1d956",
  "signature": "0xd3696d88ae37871f79356a8cc5fee465a6cf514e7e875a6e4e004caac16079f69d03023d2deecbaf8e11fd300572b25dd9a7669986e8c6dbbb712f489071ce23",
  "status": "NOT_STARTED",
  "bridgeStatus": null,
  "order": {
    "owner": "0xb0326588271f2531fbfc9a13d52d3da45be1d956",
    "beneficiary": "0xb0326588271f2531fbfc9a13d52d3da45be1d956",
    "srcToken": "0x4200000000000000000000000000000000000006",
    "destToken": "0xfde4c96c8593536e31f229ea8f37b2ada2699bb2",
    "srcAmount": "500000000000000",
    "destAmount": "2140607",
    "expectedAmount": "2151364",
    "kind": 0,
    "metadata": "0x",
    "deadline": 1757371581,
    "nonce": "1757367983280",
    "partnerAndFee": "90631063861114836560958097440945986548822432573276877133894239693005947666432",
    "permit": "0x",
    "bridge": {
      "protocolSelector": "0x21eaa4cd",
      "destinationChainId": 10,
      "outputToken": "0x94b008aa00579c1307b0ef2c499ad98a8ce58e58",
      "scalingFactor": 0,
      "protocolData": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001490"
    }
  },
  "bridgeMetadata": null,
  "orderVersion": "2.0.0",
  "orderHash": "0x079ea5b71361f8140259f8cf3844f7a29bb310c1cf8f8688bb5e9f40a688efcd",
  "partiallyFillable": false,
  "chainId": 8453,
  "type": "MARKET",
  "partner": "paraswap.io",
  "referrerAddress": null,
  "includeAgents": null,
  "excludeAgents": null,
  "bridgeProtocol": "ACROSS",
  "deltaGasOverhead": 185712,
  "expiresAt": "2025-09-08T22:46:21.000Z",
  "createdAt": "2025-09-08T21:46:40.398Z",
  "updatedAt": "2025-09-08T21:46:40.398Z"
}

Last updated