Skip to main content

Documentation Index

Fetch the complete documentation index at: https://new-docs.velora.xyz/llms.txt

Use this file to discover all available pages before exploring further.

A minimal Python script that calls GET /quote?mode=DELTA and prints the indicative destAmount, deadline, and hmac from the returned delta payload. Uses requests.

​
File tree

my-app/
├─ requirements.txt
└─ quote.py

​
Install

mkdir my-app && cd my-app
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install requests

​
quote.py

import requests

params = {
    "srcToken":     "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",  # ETH
    "destToken":    "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",  # USDC
    "amount":       "1000000000000000000",                          # 1 ETH
    "srcDecimals":  18,
    "destDecimals": 6,
    "side":         "SELL",
    "chainId":      1,
    "mode":         "DELTA",
    "userAddress":  "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "partner":      "my-app-name",
}

res = requests.get("https://api.velora.xyz/quote", params=params, timeout=10)
res.raise_for_status()

delta = res.json()["delta"]

print("destAmount:", delta["destAmount"])
print("deadline:  ", delta["deadline"])
print("hmac:      ", delta["hmac"])

​
Run it

python quote.py
You should see the indicative destAmount (USDC, 6 decimals), the order deadline (unix seconds), and the hmac you must pass through verbatim when building the order.

​
Next: build, sign, submit

Pass the whole delta object into POST /delta/orders/build (as the price field) to get EIP-712 typed data. Sign it with an ERC-2098 compact signature, then POST /delta/orders with the order + signature. See Delta → How it works.
Pass the delta payload verbatim to /delta/orders/build. Mutating any field (including hmac) will cause the build call to reject.