velora quote - Velora Docs

velora quote fetches a swap price from the Velora API and prints a readable summary, or the raw JSON with --json. It prices both Delta and Market; with the default --mode ALL the API returns whichever applies.

velora quote --src-token DAI --dest-token USDC --amount 1000

Tokens and amounts

Each token flag accepts a symbol or an address:

A symbol (DAI, USDC) resolves against the bundled token lists for the chain, and its decimals fill in automatically.
An address is used as-is. This includes the native placeholder 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE and the chain’s native currency symbol (ETH, MATIC), both of which map to the native token.

--amount is in human units (e.g. 1.5), not wei. For a SELL it is the source amount; for a BUY it is the destination amount. The CLI converts it using the relevant token’s decimals. When a token isn’t in the lists, set its decimals explicitly with --src-decimals / --dest-decimals; otherwise the command errors rather than guessing.

# By address, on a specific chain
velora quote --chain 1 \
  --src-token 0x6b175474e89094c44da98b954eedeac495271d0f \
  --dest-token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \
  --amount 1000

Options

Multi-word flags also accept a camelCase alias (e.g. --srcToken for --src-token), matching the --payload key names.

Flag	Required	Description
`--amount <amount>`	yes	Amount in human units — source amount for `SELL`, dest amount for `BUY`
`--src-token <token>`	yes	Source token symbol or address (or native placeholder)
`--dest-token <token>`	yes	Destination token symbol or address
`--src-decimals <n>`	no	Source token decimals (resolved from the token lists if omitted)
`--dest-decimals <n>`	no	Destination token decimals (resolved from the token lists if omitted)
`--chain <id>`	no	Source chain id (default `1`, Ethereum)
`--side <SELL\|BUY>`	no	Trade side (default `SELL`)
`--mode <DELTA\|MARKET\|ALL>`	no	Pricing mode (default `ALL`)
`--user-address <address>`	no	End-user wallet address
`--partner <name>`	no	Partner identifier (default `velora-cli`)
`--partner-fee-bps <bps>`	no	Partner fee in basis points (0–200, e.g. `50` = 0.5%)
`--max-impact <pct>`	no	Max acceptable price impact, in percent
`--max-usd-impact <usd>`	no	Max acceptable price impact, in USD
`--dest-chain <id>`	no	Destination chain id for a crosschain quote (Delta-only)
`--api-url <url>`	no	Override the Velora API base URL
`--api-key <key>`	no	API key (defaults to the `VELORA_API_KEY` env var)
`--payload <file>`	no	JSON file of params; flags override its values
`--json`	no	Print the raw API response instead of a summary

--side is matched case-insensitively and the documented forms are uppercase (SELL, BUY); the same goes for --mode (DELTA, MARKET, ALL).

Pricing modes

With --mode ALL (the default) the API returns one shape: a Delta intent when one is available, or a Market route otherwise. The summary’s path: line tells you which came back, and notes when Delta was unavailable and the quote fell back to Market. Force a single mode when you need it:

# Gasless Delta intent only
velora quote --src-token DAI --dest-token USDC --amount 1000 --mode DELTA

# On-chain Market route only
velora quote --src-token DAI --dest-token USDC --amount 1000 --mode MARKET

Crosschain quotes

Pass --dest-chain (differing from --chain) for a crosschain quote. These are Delta-only, so the command rejects --mode MARKET for them.

# 1,000 USDC on Ethereum → USDC on Arbitrum
velora quote --chain 1 --dest-chain 42161 \
  --src-token USDC --dest-token USDC --amount 1000 --mode DELTA

Reusable params with `--payload`

--payload <file> reads a JSON object whose camelCase keys mirror the flags, so you can pin the params that rarely change (like userAddress, apiKey, partner) in a file and pass only the trade specifics on the command line. A flag, when given, overrides the matching payload value; the payload fills in for any omitted flag.

trade.json

{
  "partner": "my-app-name",
  "userAddress": "0x1111111111111111111111111111111111111111",
  "apiKey": "<your-api-key>",
  "srcToken": "DAI",
  "destToken": "USDC"
}

velora quote --payload trade.json --amount 1000

Allowed keys: amount, srcToken, destToken, srcDecimals, destDecimals, chain, destChain, side, mode, userAddress, partner, partnerFeeBps, maxImpact, maxUsdImpact, apiUrl, apiKey. Values may be strings, numbers, or booleans; unknown keys are rejected so typos surface early. (maxUsdImpact maps to the API’s maxUSDImpact.)

JSON output

--json prints the raw API response to stdout, so you can redirect it or pipe it on:

# Save to a file
velora quote --src-token DAI --dest-token USDC --amount 1000 --json > quote.json

# Pipe into jq
velora quote --src-token DAI --dest-token USDC --amount 1000 --json | jq '.delta.destAmount'

Install: set up the velora binary and an API key.
SDK: the library the CLI wraps, for building and submitting orders.
Delta API quote: the underlying endpoint and its full response shape.

​Tokens and amounts

​Options

​Pricing modes

​Crosschain quotes

​Reusable params with --payload

​JSON output

​Related pages

Tokens and amounts

Options

Pricing modes

Crosschain quotes

Reusable params with `--payload`

JSON output

Related pages