ParaSwapUser Documentation

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 ParaSwap 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 ParaSwap Delta network.

Request Body Params

Name
Type
Description

order*

Order

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.

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": "39fab1ec-c6f9-4ef6-928b-16ce86112810",
  "deltaVersion": "2.0",
  "status": "NOT_STARTED",
  "user": "0x75c94990d2ad92d8da4e0a238d872d09ec16706e",
  "order": {
    "owner": "0x75c94990d2ad92d8da4e0a238d872d09ec16706e",
    "beneficiary": "0x75c94990d2ad92d8da4e0a238d872d09ec16706e",
    "srcToken": "0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca",
    "destToken": "0x50c5725949a6f0c72e6c4a641f24049a917db0cb",
    "srcAmount": "10000000",
    "destAmount": "9946107391620902390",
    "expectedDestAmount": "9996087830774776272",
    "deadline": 1731321473,
    "nonce": "1731317878078",
    "partnerAndFee": "20974155095831688201008782508213971467846289911829368236151719561677686964224",
    "permit": "0x0000000000000000000000000000000000000000000000000000000000000009932f84ee9561af8b307bef8b1c4f671837b4944aa10b3230445b770173a5adecd25e3972824de809987eb28fbcc8a7d1f0f21ff5f1bc14b48271e8615777e158"
  },
  "orderHash": "0x8b2fe7008d5d58eca697ffe8473e539aa28f1ee5be71c820189a2f6197064640",
  "chainId": 8453,
  "transactions": [],
  "partiallyFillable": false,
  "partner": "paraswap.io",
  "expiresAt": "2024-11-11T10:37:53.000Z",
  "createdAt": "2024-11-11T09:38:00.291Z",
  "updatedAt": "2024-11-11T09:38:11.494Z"
}

Last updated