Create a quote

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 [e-mail].

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.

POST /trading/quotes

TypeScript

TypeScript

const response: Promise<FireblocksResponse<QuotesResponse>> = fireblocks.tradingBeta.createQuote(tradingBetaApiCreateQuoteRequest);

201

{
  "quotes": [
    {
      "via": {
        "type": "PROVIDER_ACCOUNT",
        "providerId": "bridge-provider-001",
        "accountId": "acc_9f4e2d8b1c6a5e73"
      },
      "id": "quote_8f2e4d1a9c5b7e3f",
      "type": "COMMITTED",
      "baseAssetId": "USDC",
      "quoteAssetId": "BTC",
      "baseAmount": "1000.00",
      "quoteAmount": "0.02458",
      "priceImpact": 0.005,
      "quoteMinAmount": "0.02450",
      "expiresAt": "2024-01-15T10:35:00.000Z",
      "executionSteps": [
        {
          "type": "EXECUTE",
          "fee": {
            "feeType": "ORDER",
            "assetId": "USDC",
            "amountType": "FIXED",
            "amount": "2.50"
          }
        }
      ],
      "generalFees": [
        {
          "feeType": "ORDER",
          "assetId": "USDC",
          "amountType": "FIXED",
          "amount": "2.50"
        }
      ]
    }
  ],
  "quoteFailures": [
    {
      "providerId": "BRIDGE",
      "accountId": "acc_9f4e2d8b1c6a5e73",
      "error": {
        "code": 3107,
        "message": "This trading pair is not supported by the provider."
      }
    },
    {
      "providerId": "UNISWAP",
      "error": {
        "code": 3101,
        "message": "Provider not found.",
        "descriptor": {
          "providerId": "UNISWAP"
        }
      }
    }
  ]
}

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.

Body

application/json

scope · object[] · required

Show child attributes

baseAssetId · string · required

The asset you receive on BUY / give on SELL.

quoteAssetId · string · required

The counter asset used to pay/receive.

baseAmount · string · required

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

Pattern: ^\d+(\.\d+)?$

Example:

"100.00"

side · enum<string> · required

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

Available options: BUY, SELL

baseAssetRail · enum<string>

Transfer rail:

• BLOCKCHAIN - Transfer over the public blockchain
• INTERNAL - Internal transfer within the same account (e.g. sub-accounts or same api key)
• 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
• LBT - Local bank transfers within Africa
• MOMO - Mobile money transfers (e.g. M-Pesa)
• CHAPS - The Clearing House Automated Payment System (CHAPS) is a real-time gross settlement payment system used for transactions in the United Kingdom
• PAYID - PayID payment identifier system (Australia)
• INTERAC - Interac electronic funds transfer (Canada)
• INTERNAL_TRANSFER - Internal transfer between accounts

Available options: BLOCKCHAIN, INTERNAL, SWIFT, IBAN, US_WIRE, ACH, SEPA, SPEI, PIX, LBT, MOMO, CHAPS, PAYID, INTERAC, INTERNAL_TRANSFER

Example:

"BLOCKCHAIN"

quoteAssetRail · enum<string>

Transfer rail:

• BLOCKCHAIN - Transfer over the public blockchain
• INTERNAL - Internal transfer within the same account (e.g. sub-accounts or same api key)
• 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
• LBT - Local bank transfers within Africa
• MOMO - Mobile money transfers (e.g. M-Pesa)
• CHAPS - The Clearing House Automated Payment System (CHAPS) is a real-time gross settlement payment system used for transactions in the United Kingdom
• PAYID - PayID payment identifier system (Australia)
• INTERAC - Interac electronic funds transfer (Canada)
• INTERNAL_TRANSFER - Internal transfer between accounts

Available options: BLOCKCHAIN, INTERNAL, SWIFT, IBAN, US_WIRE, ACH, SEPA, SPEI, PIX, LBT, MOMO, CHAPS, PAYID, INTERAC, INTERNAL_TRANSFER

Example:

"BLOCKCHAIN"

slippageBps · number · default: 50

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

Required range: 1 <= x <= 10000

settlement · object

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

Show child attributes

Example:

{
  "type": "DVP",
  "sourceAccount": {
    "type": "VAULT_ACCOUNT",
    "id": "vault_acc_3f7e1d9b2c5a8e4f"
  },
  "destinationAccount": {
    "type": "VAULT_ACCOUNT",
    "id": "vault_acc_7b2e5d8f1c4a9e3b"
  }
}

Response

201

application/json

Quote created

quotes · object[] · required

Option 1

Option 2

Show child attributes

Example:

{ "type": "COMMITTED" }

quoteFailures · object[] · required

List of partial failures encountered while requesting quotes. Empty when all quote attempts succeed.

Show child attributes