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 Node script that calls GET /quote?mode=DELTA and prints the indicative destAmount, deadline, and hmac from the returned delta payload. No SDK — just fetch.

File tree

my-app/
├─ package.json
├─ tsconfig.json
└─ src/
   └─ quote.ts

Install

mkdir my-app && cd my-app
pnpm init
pnpm add -D typescript tsx @types/node
pnpm tsc --init

src/quote.ts

const params = new URLSearchParams({
  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',
});

const res = await fetch(`https://api.velora.xyz/quote?${params}`);

if (!res.ok) {
  throw new Error(`HTTP ${res.status}: ${await res.text()}`);
}

const { delta } = await res.json();

console.log('destAmount:', delta.destAmount);
console.log('deadline:  ', delta.deadline);
console.log('hmac:      ', delta.hmac);

Run it

pnpm tsx src/quote.ts
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.