Skip to main content
POST
Build transaction

Headers

X-BRDG-Api-Key
string

Optional partner key for server integrators. With it, each wallet is rate limited under the partner rather than on the IP of the calling server (a call naming no wallet, per the userIp in the body), bounded by a partner-wide ceiling. Unknown or disabled keys are refused with 401. See rate limits.

Body

application/json
decisionId
string
required

The decisionId from the quote response.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
venue
string

Build this venue's quote instead of best.

Required string length: 1 - 40
quoteId
string

Build this quote instead of best. Must be a quoteId from the same quote response.

Required string length: 1 - 200
privacy
boolean
default:false

Optional. Privacy already carries over from the quote.

userIp

Optional. userIp already carries over from the quote.

atomicBatch
boolean

Optional, false when omitted. Send true only when the wallet will submit every returned step together as ONE atomic EIP-5792 bundle (wallet_sendCalls with atomicRequired). Then a route that can carry the fee that way returns a fee step beside the bridge step, listed in feeBatch. Otherwise the build returns no fee step, and the fee rides the venue's own transaction or is not charged. A transfer from Tron never carries a fee step.

Response

The transfer id and the unsigned steps

transferId
string
required

Id of the transfer. Use it to submit and to track.

venue
string
required
steps
object[]
required

Transactions to sign, in order.

expiresAt
integer
required

Unix time in milliseconds after which these steps can no longer be submitted.

amountInAtomic
string
required
expectedOutAtomic
string
required

Amount expected to arrive. Matches the quoted amountOutAtomic.

minOutAtomic
string
required

The least the transfer can deliver.

feeCapture
enum<string>
required

How the platform fee is collected. See the Fees page.

Available options:
venue-param,
merged,
separate-step,
batch,
none
referralCapture
enum<string> | null
required
Available options:
merged,
batch,
none,
null
feeBasis
enum<string>
required
Available options:
carved,
added
requoted
boolean
required
deposit
object

Set only when steps is empty: send exactly amountAtomic to address before deadlineMs.

feeBatch
object

The steps a wallet with EIP-5792 batching can sign as one bundle.

requote
object
boardDrift
object