Skip to main content
POST
/
transactions
/
{network}
Build calldata for a Market swap
curl --request POST \
  --url https://api.velora.xyz/transactions/{network} \
  --header 'Content-Type: application/json' \
  --data '
{
  "priceRoute": {},
  "userAddress": "<string>",
  "srcToken": "<string>",
  "destToken": "<string>",
  "srcAmount": "<string>",
  "destAmount": "<string>",
  "slippage": 123
}
'
{}

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.

How this call breaks in production

SymptomRoot causeFix
400 Invalid priceRoute or Stale priceRoutepriceRoute modified between quote and tx-build, or older than ~30sPass the priceRoute block from POST /quote verbatim; re-quote if more than ~30s elapsed
Calldata reverts on-chain with INSUFFICIENT_OUTPUTSlippage tolerance too tight for current market depthIncrease slippage (in bps) on the rebuild, or surface a higher tolerance to the user before retrying
Calldata reverts with TransferHelper: TRANSFER_FROM_FAILEDERC-20 allowance to the v6.2 router insufficient (or pointed at the legacy v5 router)Approve the Augustus v6.2 router address — see Chains & contracts; migrating off v5 → Augustus v5 → v6.2
txData gas estimate fails on the user’s RPCRPC gas estimation can’t simulate the exact block conditionsUse the gas field returned in the response as a baseline + 15–25% headroom
Calldata builds for the wrong chainnetwork path parameter mismatched against the priceRoute.networkAlways derive :network from priceRoute.network, not from a client-side variable
422 Partner not allowedPartner-key tier doesn’t permit the requested fee/surplus configurationDrop the disallowed param, or contact partnerships to upgrade the tier
Updated from support tickets at each release. Last updated: 2026-05-15.

Path Parameters

network
integer
required

Body

application/json
priceRoute
object
required

The priceRoute block returned by POST /quote, passed verbatim.

userAddress
string
required
srcToken
string
destToken
string
srcAmount
string
destAmount
string
slippage
integer

Response

Augustus calldata + tx fields

The response is of type object.