# Submit a Delta Order

## Submit Delta Order for Auction

<mark style="color:blue;">`POST`</mark> `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

<table><thead><tr><th width="252">Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>order<mark style="color:red;">*</mark></td><td>Order</td><td>The <a href="/pages/QRAOD1DNcP9Vk06NEAGf">built</a> order to be submitted. </td></tr><tr><td>signature<mark style="color:red;">*</mark></td><td>string</td><td>Signature of the order from <code>order.owner</code> address. EOA signatures must be submitted in ERC-2098 Compact Representation. </td></tr><tr><td>chainId<mark style="color:red;">*</mark></td><td>string</td><td>Chain ID. (Mainnet - 1, Optimism - 10, BSC - 56, Polygon - 137, Fantom - 250, zkEVM - 1101, Base - 8453, Arbitrum - 42161, Avalanche - 43114, Gnosis - 100).</td></tr><tr><td>type</td><td>MARKET | LIMIT</td><td>Indicates order type.  Defaults to <code>MARKET</code>. Used for filtering only</td></tr><tr><td>partiallyFillable</td><td>boolean</td><td>Allow the order to be filled in parts. Default: <code>false</code></td></tr><tr><td>partner</td><td>string</td><td>Partner string.</td></tr><tr><td>includeAgents</td><td>string[]</td><td>List of agent names to include. If not provided, all the agents are included</td></tr><tr><td>excludeAgents</td><td>string[]</td><td>List of agent names to exclude. If not provided, none of the agents are excluded</td></tr><tr><td>referrerAddress</td><td>string</td><td>Referrer address</td></tr></tbody></table>

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

{% tabs %}
{% tab title="200 Successful Create Order Response." %}

```json
{
  "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"
}
```

{% endtab %}

{% tab title="400 Get Action Error" %}

```
{
  "error": "Validation failed with error"
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.velora.xyz/api/velora-api/velora-delta-api/submit-a-delta-order.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.