Skip to main content
POST
Build fast fill

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 fast fill 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
Required string length: 1 - 40
quoteId
string

Build this quote instead of best.

Required string length: 1 - 200
userIp
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 its signature step

transferId
string
required
venue
string
required
steps
object[]
required
expiresAt
integer
required
amountInAtomic
string
required
expectedOutAtomic
string
required
minOutAtomic
string
required
feeCapture
enum<string>
required
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
feeBatch
object
permit
object | null
relayFeePermit
object | null
spotTransfer
object | null
requote
object
boardDrift
object