Create a quote

post

https://api.fireblocks.io/v1/trading/quotes

Generate a time-limited quote for asset conversion, providing exchange rate and amount calculations.

Note: These endpoints are currently in beta and might be subject to changes.

If you want to participate and learn more about the Fireblocks Trading, please contact your Fireblocks Customer Success Manager or send an email to [email protected].

Endpoint Permission: Owner, Admin, Non-Signing Admin, Signer, Editor.

For detailed information about error codes and troubleshooting, please refer to our API Error Codes documentation.

Body Params

scope

array

required

scope*

baseAssetId

string

required

The asset you receive on BUY / give on SELL.

baseAssetRail

string

enum

Transfer rail:

BLOCKCHAIN - Transfer over the public blockchain
INTERNAL - Internal transfer within the same account (e.g. sub-accounts or same api key)
PEER - Peer transfer within the same provider network
SWIFT - International wire transfer
IBAN - International Bank Account Number transfer
US_WIRE - Domestic wire transfer within the United States (e.g. FedWire)
ACH - Automated Clearing House transfer, typically takes longer but not as expensive as wire transfers
SEPA - Euro transfers within the SEPA zone
SPEI - Mexican interbank electronic payment system
PIX - Brazilian instant payment system
LOCAL_BANK_TRANSFER_AFRICA - Local bank transfers within Africa
MOBILE_MONEY - Mobile money transfers (e.g. M-Pesa)
INTERNAL_TRANSFER - Internal transfer within the same account
INTERAC - Canadian interbank transfer system
PAYID - Australian PayID payment system
CHAPS - The Clearing House Automated Payment System (CHAPS) is a real-time gross settlement payment system used for transactions in the United Kingdom

quoteAssetId

string

required

The counter asset used to pay/receive.

quoteAssetRail

string

enum

Transfer rail:

BLOCKCHAIN - Transfer over the public blockchain
INTERNAL - Internal transfer within the same account (e.g. sub-accounts or same api key)
PEER - Peer transfer within the same provider network
SWIFT - International wire transfer
IBAN - International Bank Account Number transfer
US_WIRE - Domestic wire transfer within the United States (e.g. FedWire)
ACH - Automated Clearing House transfer, typically takes longer but not as expensive as wire transfers
SEPA - Euro transfers within the SEPA zone
SPEI - Mexican interbank electronic payment system
PIX - Brazilian instant payment system
LOCAL_BANK_TRANSFER_AFRICA - Local bank transfers within Africa
MOBILE_MONEY - Mobile money transfers (e.g. M-Pesa)
INTERNAL_TRANSFER - Internal transfer within the same account
INTERAC - Canadian interbank transfer system
PAYID - Australian PayID payment system
CHAPS - The Clearing House Automated Payment System (CHAPS) is a real-time gross settlement payment system used for transactions in the United Kingdom

baseAmount

string

required

Amount in baseAssetId. BUY = base amount to receive; SELL = base amount to sell.

slippageBps

number

1 to 10000

Defaults to 50

Slippage tolerance in basis points (bps) for defi quotes - 1 is 0.01% and 10000 is 100%

settlement

object

Source/Destination accounts for the quote (must have for defi quotes)

side

string

enum

required

BUY: receive base / pay quote; SELL: give base / receive quote.

Allowed:

Headers

Idempotency-Key

string

A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.

Responses

201Quote created

400Bad request: invalid input parameters, malformed request body, or validation failure.

401Unauthorized. Missing / invalid JWT token in Authorization header.

403Forbidden: insufficient permissions, disabled feature, or restricted access.

429Rate limit exceeded: slow down and retry later.

5XXInternal error while processing the request.

defaultError Response