Skip to main content
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.
FlagRequiredDescription
--amount <amount>yesAmount in human units — source amount for SELL, dest amount for BUY
--src-token <token>yesSource token symbol or address (or native placeholder)
--dest-token <token>yesDestination token symbol or address
--src-decimals <n>noSource token decimals (resolved from the token lists if omitted)
--dest-decimals <n>noDestination token decimals (resolved from the token lists if omitted)
--chain <id>noSource chain id (default 1, Ethereum)
--side <SELL|BUY>noTrade side (default SELL)
--mode <DELTA|MARKET|ALL>noPricing mode (default ALL)
--user-address <address>noEnd-user wallet address
--partner <name>noPartner identifier (default velora-cli)
--partner-fee-bps <bps>noPartner fee in basis points (0–200, e.g. 50 = 0.5%)
--max-impact <pct>noMax acceptable price impact, in percent
--max-usd-impact <usd>noMax acceptable price impact, in USD
--dest-chain <id>noDestination chain id for a crosschain quote (Delta-only)
--api-url <url>noOverride the Velora API base URL
--api-key <key>noAPI key (defaults to the VELORA_API_KEY env var)
--payload <file>noJSON file of params; flags override its values
--jsonnoPrint 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.
Last modified on June 22, 2026