Skip to main content
POST
/
trading
/
quotes
TypeScript
const response: Promise<FireblocksResponse<QuotesResponse>> = fireblocks.tradingBeta.createQuote(tradingBetaApiCreateQuoteRequest);
{
  "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"
        }
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developers.fireblocks.com/llms.txt

Use this file to discover all available pages before exploring further.

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
​
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)

Example:
{
  "type": "DVP",
  "sourceAccount": {
    "type": "VAULT_ACCOUNT",
    "id": "vault_acc_3f7e1d9b2c5a8e4f"
  },
  "destinationAccount": {
    "type": "VAULT_ACCOUNT",
    "id": "vault_acc_7b2e5d8f1c4a9e3b"
  }
}
​
participantsIdentification
object

KYC/AML participant identification

Example:
{
  "originator": {
    "externalReferenceId": "user_123456",
    "entityType": "INDIVIDUAL",
    "participantRelationshipType": "FirstParty",
    "fullName": { "firstName": "John", "lastName": "Smith" },
    "dateOfBirth": "1985-03-15",
    "email": "john.smith@example.com",
    "phone": "+14155551234",
    "postalAddress": {
      "streetName": "Main Street",
      "buildingNumber": "123",
      "postalCode": "10001",
      "city": "New York",
      "subdivision": "NY",
      "district": "Manhattan",
      "country": "US"
    }
  },
  "beneficiary": {
    "externalReferenceId": "user_789012",
    "entityType": "INDIVIDUAL",
    "participantRelationshipType": "ThirdParty",
    "fullName": {
      "firstName": "Alice",
      "lastName": "Johnson"
    },
    "dateOfBirth": "1990-07-22",
    "email": "alice.johnson@example.com",
    "phone": "+14155551234",
    "postalAddress": {
      "streetName": "Broadway",
      "buildingNumber": "456",
      "postalCode": "10002",
      "city": "New York",
      "subdivision": "NY",
      "district": "Manhattan",
      "country": "US"
    }
  }
}

Response

Quote created

​
quotes
object[]
required
​
quoteFailures
object[]
required

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