/v2/delta/orders

Submit a signed Delta V2 order. The relayer validates signature, balance, and allowance, then enrolls it into the sealed-bid auction.

POST /v2/delta/orders

Submit a signed Delta V2 order

cURL

curl --request POST \
  --url https://api.velora.xyz/v2/delta/orders \
  --header 'Content-Type: application/json' \
  --data '
{
  "chainId": 123,
  "order": {},
  "signature": "<string>",
  "partner": "my-app-name",
  "type": "MARKET",
  "referrerAddress": "<string>",
  "partiallyFillable": false,
  "includeAgents": [
    "<string>"
  ],
  "excludeAgents": [
    "<string>"
  ]
}
'

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "input": {
    "chainId": 123,
    "token": "<string>",
    "amount": "<string>",
    "expectedAmount": "<string>",
    "executedAmount": "<string>"
  },
  "output": {
    "chainId": 123,
    "token": "<string>",
    "amount": "<string>",
    "expectedAmount": "<string>",
    "executedAmount": "<string>"
  },
  "owner": "<string>",
  "beneficiary": "<string>",
  "orderHash": "<string>",
  "partner": "<string>",
  "order": {},
  "transactions": [
    {
      "originTx": "<string>",
      "destinationTx": "<string>",
      "filledPercent": 123,
      "spentAmount": "<string>",
      "receivedAmount": "<string>"
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "expiresAt": "2023-11-07T05:31:56Z"
}

Body

application/json

chainId · integer · required

order · object · required

The toSign.value returned by POST /v2/delta/orders/build, sent verbatim.

signature · string · required

EIP-712 signature over order.

partner · string · required

Example:

"my-app-name"

type · enum<string> · default: MARKET

Available options: MARKET, LIMIT

referrerAddress · string

partiallyFillable · boolean · default: false

includeAgents · string[]

excludeAgents · string[]

Response

200

application/json

Order accepted.

V2 order shape returned by every order endpoint (reads and posts). input and output carry the expected + executed amounts so you don't need to compute fill-percent yourself. onChainOrderType selects the family the order struct belongs to.

id · string<uuid>

status · enum<string>

Available options: PENDING, AWAITING_SIGNATURE, ACTIVE, SUSPENDED, CANCELLING, BRIDGING, COMPLETED, FAILED, EXPIRED, CANCELLED, REFUNDED

side · enum<string>

Available options: SELL, BUY

type · enum<string>

Available options: MARKET, LIMIT

onChainOrderType · enum<string>

Available options: Order, FillableOrder, ProductiveOrder, ExternalOrder, TWAPOrder, TWAPBuyOrder

input · object

Source-side token movement. SELL: { chainId, token, amount }. BUY: { chainId, token, expectedAmount, executedAmount }.

Show child attributes

output · object

Destination-side token movement. SELL: { chainId, token, expectedAmount, executedAmount }. BUY: { chainId, token, amount }.

Show child attributes

owner · string

beneficiary · string

orderHash · string

partner · string

order · object

The signed on-chain Order struct.

transactions · object[]

Show child attributes

createdAt · string<date-time>

updatedAt · string<date-time>

expiresAt · string<date-time>