---
title: "Create a quote"
method: POST
path: "/trading/quotes"
tags: ["Trading"]
---

# Create a quote

`POST /trading/quotes`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/trading/quotes`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/trading/quotes/post.ts> (a function with typed inputs; its response is checked against the schema)

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

If `side` is omitted it defaults to `SELL`. Use `side: BOTH` to get quotes for each side the provider supports in a single call; providers that support only one side return that side only. Every returned quote carries a concrete `BUY` or `SELL` side, never `BOTH`.

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](https://developers.fireblocks.com/reference/api-error-codes).

## Headers

- `Idempotency-Key` string

## Request body

- CreateQuote
  - `scope` ScopeItem[], required
    - `providerId` string, required: The ID of the provider associated with the account.
    - `accountId` string: The ID of the account associated with the provider.
  - `baseAssetId` string, required: The asset you receive on BUY / give on SELL.
  - `baseAssetRail` 'BLOCKCHAIN' | 'INTERNAL' | 'SWIFT' | 'IBAN' | 'US_WIRE' | 'ACH' | 'SEPA' | 'SPEI' | 'PIX' | 'LBT' | 'MOMO' | 'CHAPS' | 'PAYID' | 'INTERAC' | 'INTERNAL_TRANSFER' | 'CIPS' | 'NEQUI' | 'FPS_UK' | 'FPS_HK' | 'INSTA_PAY' | 'PESONET': 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 * **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 * **CIPS** - Cross-Border Interbank Payment System (China) * **NEQUI** - Nequi mobile payment (Colombia) * **FPS_UK** - UK Faster Payments (GBP) * **FPS_HK** - Hong Kong Faster Payment System (HKD) * **INSTA_PAY** - InstaPay instant payment (Philippines) * **PESONET** - PesoNet batch payment (Philippines)
  - `quoteAssetId` string, required: The counter asset used to pay/receive.
  - `quoteAssetRail` 'BLOCKCHAIN' | 'INTERNAL' | 'SWIFT' | 'IBAN' | 'US_WIRE' | 'ACH' | 'SEPA' | 'SPEI' | 'PIX' | 'LBT' | 'MOMO' | 'CHAPS' | 'PAYID' | 'INTERAC' | 'INTERNAL_TRANSFER' | 'CIPS' | 'NEQUI' | 'FPS_UK' | 'FPS_HK' | 'INSTA_PAY' | 'PESONET': 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 * **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 * **CIPS** - Cross-Border Interbank Payment System (China) * **NEQUI** - Nequi mobile payment (Colombia) * **FPS_UK** - UK Faster Payments (GBP) * **FPS_HK** - Hong Kong Faster Payment System (HKD) * **INSTA_PAY** - InstaPay instant payment (Philippines) * **PESONET** - PesoNet batch payment (Philippines)
  - `baseAmount` string, required: Amount in baseAssetId. BUY = base amount to receive; SELL = base amount to sell.
  - `slippageBps` number: Slippage tolerance in basis points (bps) for defi quotes - 1 is 0.01% and 10000 is 100%
  - `settlement` DVPSettlement: Source/Destination accounts for the quote (must have for defi quotes)
    - `type` 'DVP', required
    - `sourceAccount` union, required
      - PlatformAccount
        - `type` 'VAULT_ACCOUNT' | 'CONNECTED_ACCOUNT' | 'FIAT_ACCOUNT', required
        - `accountId` string, required
      - ExternalAccount
        - `type` 'EXTERNAL', required
        - `senderInformation` union: Additional data for the external account, depending on the type used.
          - ExternalAccountMobileMoney
            - `type` 'MOBILE_MONEY_RAIL', required
            - `mobilePhoneNumber` string, required: Mobile phone number in E.164 format
            - `provider` 'M_PESA' | 'AIRTEL' | 'MTN' | 'TIGO' | 'ORANGE', required
            - `email` string, email, required
            - `successRedirectUrl` string: URL to redirect the end user back to after they complete the payment on the bank/mobile provider page (e.g., the merchant checkout page)
          - ExternalAccountLocalBankAfrica
            - `successRedirectUrl` string: URL to redirect the end user back to after they complete the payment on the bank/mobile provider page (e.g., the merchant checkout page)
    - `destinationAccount` union, required
      - InternalReference
        - `type` 'VAULT_ACCOUNT' | 'EXCHANGE_ACCOUNT' | 'UNMANAGED_WALLET' | 'FIAT_ACCOUNT' | 'CONNECTED_ACCOUNT', required
        - `accountId` string, required
      - OneTimeAddressReference
        - `type` 'ONE_TIME_ADDRESS', required
        - `address` string, required
        - `tag` string
  - `side` 'BUY' | 'SELL' | 'BOTH': Side to price on a quote, rate or offer request. BUY: receive base / pay quote; SELL: give base / receive quote; BOTH: request pricing for both sides at once. Providers that support only one of the sides return entries for that side only. BOTH is accepted on requests only, never on order execution requests, and responses never return it: every returned quote, rate or offer carries a concrete BUY or SELL. When omitted, defaults to SELL.
  - `participantsIdentification` ParticipantsIdentification: KYC/AML participant identification
    - `originator` union
      - PersonalIdentification
        - `externalReferenceId` string, required
        - `entityType` 'INDIVIDUAL', required
        - `participantRelationshipType` 'FirstParty' | 'SecondParty' | 'ThirdParty', required
        - `fullName` object, required
          - `firstName` string, required
          - `lastName` string, required
        - `dateOfBirth` string, date, required
        - `postalAddress` PostalAddress, required
          - `streetName` string, required
          - `buildingNumber` string, required
          - `postalCode` string, required
          - `city` string, required
          - `subdivision` string, required
          - `district` string, required
          - `country` string, required
        - `email` string, email
        - `phone` string: Mobile phone number in E.164 format
        - `idNumber` string: Deprecated. Use identificationDocuments instead.
        - `idType` 'NIN_SLIP_CARD' | 'BVN' | 'ID_CARD' | 'ID_BOOK' | 'NATIONAL_ID' | 'ALIEN_CARD' | 'PASSPORT' | 'ECOWAS_CARD' | 'RWANDA_CARD' | 'DRIVERS_LICENSE' | 'RESIDENT_CARD' | 'VOTER_ID' | 'HEALTH_INSURANCE_ID' | 'GHANA_CARD' | 'REFUGEE_ID' | 'SSNIT' | 'NON_CITIZEN_ID' | 'NATIONAL_REGISTRATION_CARD': Type of identification document. Acceptable values are: - 'NIN_SLIP_CARD': National Identification Number (NIN) Slip Card - temporary identification card issued in Nigeria - 'BVN': Bank Verification Number - unique identity number for bank account holders in Nigeria - 'ID_CARD': General national identity card - 'ID_BOOK': Identity book or booklet format identification document - 'NATIONAL_ID': National identity document issued by government authorities - 'ALIEN_CARD': Alien registration card for foreign nationals - 'PASSPORT': International travel document and proof of identity - 'ECOWAS_CARD': Economic Community of West African States identification card - 'RWANDA_CARD': Rwandan national identification card - 'DRIVERS_LICENSE': Driver's license or driving permit - 'RESIDENT_CARD': Resident permit or permanent resident card - 'VOTER_ID': Voter identification card used for electoral registration - 'HEALTH_INSURANCE_ID': Health insurance identification card - 'GHANA_CARD': Ghana Card - national identification card issued in Ghana - 'REFUGEE_ID': Refugee identification document - 'SSNIT': Social Security and National Insurance Trust ID - social security number in Ghana - 'NON_CITIZEN_ID': Identification document for non-citizens or foreign residents - 'NATIONAL_REGISTRATION_CARD': National registration card issued by national registration authority
        - `additionalIdNumber` string: Deprecated. Use identificationDocuments instead.
        - `additionalIdType` 'NIN_SLIP_CARD' | 'BVN' | 'ID_CARD' | 'ID_BOOK' | 'NATIONAL_ID' | 'ALIEN_CARD' | 'PASSPORT' | 'ECOWAS_CARD' | 'RWANDA_CARD' | 'DRIVERS_LICENSE' | 'RESIDENT_CARD' | 'VOTER_ID' | 'HEALTH_INSURANCE_ID' | 'GHANA_CARD' | 'REFUGEE_ID' | 'SSNIT' | 'NON_CITIZEN_ID' | 'NATIONAL_REGISTRATION_CARD': Type of identification document. Acceptable values are: - 'NIN_SLIP_CARD': National Identification Number (NIN) Slip Card - temporary identification card issued in Nigeria - 'BVN': Bank Verification Number - unique identity number for bank account holders in Nigeria - 'ID_CARD': General national identity card - 'ID_BOOK': Identity book or booklet format identification document - 'NATIONAL_ID': National identity document issued by government authorities - 'ALIEN_CARD': Alien registration card for foreign nationals - 'PASSPORT': International travel document and proof of identity - 'ECOWAS_CARD': Economic Community of West African States identification card - 'RWANDA_CARD': Rwandan national identification card - 'DRIVERS_LICENSE': Driver's license or driving permit - 'RESIDENT_CARD': Resident permit or permanent resident card - 'VOTER_ID': Voter identification card used for electoral registration - 'HEALTH_INSURANCE_ID': Health insurance identification card - 'GHANA_CARD': Ghana Card - national identification card issued in Ghana - 'REFUGEE_ID': Refugee identification document - 'SSNIT': Social Security and National Insurance Trust ID - social security number in Ghana - 'NON_CITIZEN_ID': Identification document for non-citizens or foreign residents - 'NATIONAL_REGISTRATION_CARD': National registration card issued by national registration authority
        - `nationality` string: The ISO-3166 Alpha-2 country code representing the individual's nationality.
        - `identificationDocuments` PersonalIdentificationDocument[]: List of identification documents for the individual.
          - `id` string: The identification document number.
          - `type` 'NIN_SLIP_CARD' | 'BVN' | 'ID_CARD' | 'ID_BOOK' | 'NATIONAL_ID' | 'ALIEN_CARD' | 'PASSPORT' | 'ECOWAS_CARD' | 'RWANDA_CARD' | 'DRIVERS_LICENSE' | 'RESIDENT_CARD' | 'VOTER_ID' | 'HEALTH_INSURANCE_ID' | 'GHANA_CARD' | 'REFUGEE_ID' | 'SSNIT' | 'NON_CITIZEN_ID' | 'NATIONAL_REGISTRATION_CARD': Type of identification document. Acceptable values are: - 'NIN_SLIP_CARD': National Identification Number (NIN) Slip Card - temporary identification card issued in Nigeria - 'BVN': Bank Verification Number - unique identity number for bank account holders in Nigeria - 'ID_CARD': General national identity card - 'ID_BOOK': Identity book or booklet format identification document - 'NATIONAL_ID': National identity document issued by government authorities - 'ALIEN_CARD': Alien registration card for foreign nationals - 'PASSPORT': International travel document and proof of identity - 'ECOWAS_CARD': Economic Community of West African States identification card - 'RWANDA_CARD': Rwandan national identification card - 'DRIVERS_LICENSE': Driver's license or driving permit - 'RESIDENT_CARD': Resident permit or permanent resident card - 'VOTER_ID': Voter identification card used for electoral registration - 'HEALTH_INSURANCE_ID': Health insurance identification card - 'GHANA_CARD': Ghana Card - national identification card issued in Ghana - 'REFUGEE_ID': Refugee identification document - 'SSNIT': Social Security and National Insurance Trust ID - social security number in Ghana - 'NON_CITIZEN_ID': Identification document for non-citizens or foreign residents - 'NATIONAL_REGISTRATION_CARD': National registration card issued by national registration authority
          - `expirationDate` string, date: The expiration date of the identification document.
      - BusinessIdentification
        - `externalReferenceId` string, required
        - `entityType` 'BUSINESS', required
        - `participantRelationshipType` 'FirstParty' | 'SecondParty' | 'ThirdParty', required
        - `businessName` string, required
        - `registrationNumber` string, required
        - `postalAddress` PostalAddress, required
          - `streetName` string, required
          - `buildingNumber` string, required
          - `postalCode` string, required
          - `city` string, required
          - `subdivision` string, required
          - `district` string, required
          - `country` string, required
        - `email` string, email
        - `phone` string: Mobile phone number in E.164 format
        - `dateOfRegistration` string, date: The date the business was registered.
        - `countryOfRegistration` string: The ISO-3166 Alpha-2 country code where the business is registered.
    - `beneficiary` union
      - PersonalIdentification
        - `externalReferenceId` string, required
        - `entityType` 'INDIVIDUAL', required
        - `participantRelationshipType` 'FirstParty' | 'SecondParty' | 'ThirdParty', required
        - `fullName` object, required
          - `firstName` string, required
          - `lastName` string, required
        - `dateOfBirth` string, date, required
        - `postalAddress` PostalAddress, required
          - `streetName` string, required
          - `buildingNumber` string, required
          - `postalCode` string, required
          - `city` string, required
          - `subdivision` string, required
          - `district` string, required
          - `country` string, required
        - `email` string, email
        - `phone` string: Mobile phone number in E.164 format
        - `idNumber` string: Deprecated. Use identificationDocuments instead.
        - `idType` 'NIN_SLIP_CARD' | 'BVN' | 'ID_CARD' | 'ID_BOOK' | 'NATIONAL_ID' | 'ALIEN_CARD' | 'PASSPORT' | 'ECOWAS_CARD' | 'RWANDA_CARD' | 'DRIVERS_LICENSE' | 'RESIDENT_CARD' | 'VOTER_ID' | 'HEALTH_INSURANCE_ID' | 'GHANA_CARD' | 'REFUGEE_ID' | 'SSNIT' | 'NON_CITIZEN_ID' | 'NATIONAL_REGISTRATION_CARD': Type of identification document. Acceptable values are: - 'NIN_SLIP_CARD': National Identification Number (NIN) Slip Card - temporary identification card issued in Nigeria - 'BVN': Bank Verification Number - unique identity number for bank account holders in Nigeria - 'ID_CARD': General national identity card - 'ID_BOOK': Identity book or booklet format identification document - 'NATIONAL_ID': National identity document issued by government authorities - 'ALIEN_CARD': Alien registration card for foreign nationals - 'PASSPORT': International travel document and proof of identity - 'ECOWAS_CARD': Economic Community of West African States identification card - 'RWANDA_CARD': Rwandan national identification card - 'DRIVERS_LICENSE': Driver's license or driving permit - 'RESIDENT_CARD': Resident permit or permanent resident card - 'VOTER_ID': Voter identification card used for electoral registration - 'HEALTH_INSURANCE_ID': Health insurance identification card - 'GHANA_CARD': Ghana Card - national identification card issued in Ghana - 'REFUGEE_ID': Refugee identification document - 'SSNIT': Social Security and National Insurance Trust ID - social security number in Ghana - 'NON_CITIZEN_ID': Identification document for non-citizens or foreign residents - 'NATIONAL_REGISTRATION_CARD': National registration card issued by national registration authority
        - `additionalIdNumber` string: Deprecated. Use identificationDocuments instead.
        - `additionalIdType` 'NIN_SLIP_CARD' | 'BVN' | 'ID_CARD' | 'ID_BOOK' | 'NATIONAL_ID' | 'ALIEN_CARD' | 'PASSPORT' | 'ECOWAS_CARD' | 'RWANDA_CARD' | 'DRIVERS_LICENSE' | 'RESIDENT_CARD' | 'VOTER_ID' | 'HEALTH_INSURANCE_ID' | 'GHANA_CARD' | 'REFUGEE_ID' | 'SSNIT' | 'NON_CITIZEN_ID' | 'NATIONAL_REGISTRATION_CARD': Type of identification document. Acceptable values are: - 'NIN_SLIP_CARD': National Identification Number (NIN) Slip Card - temporary identification card issued in Nigeria - 'BVN': Bank Verification Number - unique identity number for bank account holders in Nigeria - 'ID_CARD': General national identity card - 'ID_BOOK': Identity book or booklet format identification document - 'NATIONAL_ID': National identity document issued by government authorities - 'ALIEN_CARD': Alien registration card for foreign nationals - 'PASSPORT': International travel document and proof of identity - 'ECOWAS_CARD': Economic Community of West African States identification card - 'RWANDA_CARD': Rwandan national identification card - 'DRIVERS_LICENSE': Driver's license or driving permit - 'RESIDENT_CARD': Resident permit or permanent resident card - 'VOTER_ID': Voter identification card used for electoral registration - 'HEALTH_INSURANCE_ID': Health insurance identification card - 'GHANA_CARD': Ghana Card - national identification card issued in Ghana - 'REFUGEE_ID': Refugee identification document - 'SSNIT': Social Security and National Insurance Trust ID - social security number in Ghana - 'NON_CITIZEN_ID': Identification document for non-citizens or foreign residents - 'NATIONAL_REGISTRATION_CARD': National registration card issued by national registration authority
        - `nationality` string: The ISO-3166 Alpha-2 country code representing the individual's nationality.
        - `identificationDocuments` PersonalIdentificationDocument[]: List of identification documents for the individual.
          - `id` string: The identification document number.
          - `type` 'NIN_SLIP_CARD' | 'BVN' | 'ID_CARD' | 'ID_BOOK' | 'NATIONAL_ID' | 'ALIEN_CARD' | 'PASSPORT' | 'ECOWAS_CARD' | 'RWANDA_CARD' | 'DRIVERS_LICENSE' | 'RESIDENT_CARD' | 'VOTER_ID' | 'HEALTH_INSURANCE_ID' | 'GHANA_CARD' | 'REFUGEE_ID' | 'SSNIT' | 'NON_CITIZEN_ID' | 'NATIONAL_REGISTRATION_CARD': Type of identification document. Acceptable values are: - 'NIN_SLIP_CARD': National Identification Number (NIN) Slip Card - temporary identification card issued in Nigeria - 'BVN': Bank Verification Number - unique identity number for bank account holders in Nigeria - 'ID_CARD': General national identity card - 'ID_BOOK': Identity book or booklet format identification document - 'NATIONAL_ID': National identity document issued by government authorities - 'ALIEN_CARD': Alien registration card for foreign nationals - 'PASSPORT': International travel document and proof of identity - 'ECOWAS_CARD': Economic Community of West African States identification card - 'RWANDA_CARD': Rwandan national identification card - 'DRIVERS_LICENSE': Driver's license or driving permit - 'RESIDENT_CARD': Resident permit or permanent resident card - 'VOTER_ID': Voter identification card used for electoral registration - 'HEALTH_INSURANCE_ID': Health insurance identification card - 'GHANA_CARD': Ghana Card - national identification card issued in Ghana - 'REFUGEE_ID': Refugee identification document - 'SSNIT': Social Security and National Insurance Trust ID - social security number in Ghana - 'NON_CITIZEN_ID': Identification document for non-citizens or foreign residents - 'NATIONAL_REGISTRATION_CARD': National registration card issued by national registration authority
          - `expirationDate` string, date: The expiration date of the identification document.
      - BusinessIdentification
        - `externalReferenceId` string, required
        - `entityType` 'BUSINESS', required
        - `participantRelationshipType` 'FirstParty' | 'SecondParty' | 'ThirdParty', required
        - `businessName` string, required
        - `registrationNumber` string, required
        - `postalAddress` PostalAddress, required
          - `streetName` string, required
          - `buildingNumber` string, required
          - `postalCode` string, required
          - `city` string, required
          - `subdivision` string, required
          - `district` string, required
          - `country` string, required
        - `email` string, email
        - `phone` string: Mobile phone number in E.164 format
        - `dateOfRegistration` string, date: The date the business was registered.
        - `countryOfRegistration` string: The ISO-3166 Alpha-2 country code where the business is registered.

## Response `201`

Quote created

- QuotesResponse
  - `quotes` Quote[], required
    - `via` union, required: Response-only counterpart of AccessType. Used by the `via` field of response schemas (Quote, Rate, OrderDetails, OrderSummary — and therefore QuoteOffer, RateOffer and Offer) so that the PROVIDER variant can expose `subProviders` without that field ever becoming reachable from a request body. Request schemas (CreateOrderRequest.via) keep using AccessType.
      - AccountAccessResponse
        - `type` 'PROVIDER_ACCOUNT', required: Indicates this uses account-based access
        - `providerId` string: The ID of the provider
        - `accountId` string, required: The ID of the account
      - DirectAccessResponse: Response-only counterpart of DirectAccess. Adds the server-populated `subProviders` field. Never use this schema in a request body — requests must keep using DirectAccess (via AccessType).
        - `type` 'PROVIDER', required: Indicates this uses direct provider access
        - `providerId` string, required: The ID of the provider
        - `subProviders` string[]: The underlying providers or tools that this direct-access route is composed of, in execution order. Response-only: this field is populated by the server and is never accepted from client requests.
    - `id` string, required: The unique identifier of the quote.
    - `quoteAssetId` string, required: The target asset identifier.
    - `quoteAssetRail` 'BLOCKCHAIN' | 'INTERNAL' | 'SWIFT' | 'IBAN' | 'US_WIRE' | 'ACH' | 'SEPA' | 'SPEI' | 'PIX' | 'LBT' | 'MOMO' | 'CHAPS' | 'PAYID' | 'INTERAC' | 'INTERNAL_TRANSFER' | 'CIPS' | 'NEQUI' | 'FPS_UK' | 'FPS_HK' | 'INSTA_PAY' | 'PESONET': 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 * **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 * **CIPS** - Cross-Border Interbank Payment System (China) * **NEQUI** - Nequi mobile payment (Colombia) * **FPS_UK** - UK Faster Payments (GBP) * **FPS_HK** - Hong Kong Faster Payment System (HKD) * **INSTA_PAY** - InstaPay instant payment (Philippines) * **PESONET** - PesoNet batch payment (Philippines)
    - `baseAssetId` string, required: The source asset identifier.
    - `baseAssetRail` 'BLOCKCHAIN' | 'INTERNAL' | 'SWIFT' | 'IBAN' | 'US_WIRE' | 'ACH' | 'SEPA' | 'SPEI' | 'PIX' | 'LBT' | 'MOMO' | 'CHAPS' | 'PAYID' | 'INTERAC' | 'INTERNAL_TRANSFER' | 'CIPS' | 'NEQUI' | 'FPS_UK' | 'FPS_HK' | 'INSTA_PAY' | 'PESONET': 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 * **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 * **CIPS** - Cross-Border Interbank Payment System (China) * **NEQUI** - Nequi mobile payment (Colombia) * **FPS_UK** - UK Faster Payments (GBP) * **FPS_HK** - Hong Kong Faster Payment System (HKD) * **INSTA_PAY** - InstaPay instant payment (Philippines) * **PESONET** - PesoNet batch payment (Philippines)
    - `baseAmount` string, required: The amount of the base asset.
    - `quoteAmount` string, required: The amount of the quote asset.
    - `priceImpact` number: The estimated price impact as a decimal fraction.
    - `quoteMinAmount` string: The minimum guaranteed amount of the quote asset.
    - `isSlippageApplied` boolean: Indicates if slippage was applied to the quote.
    - `executionSteps` QuoteExecutionStep[]: Ordered list of execution steps for the quote.
      - `type` 'APPROVE' | 'PERMIT' | 'CONTRACT_CALL' | 'EXECUTE' | 'SETTLEMENT' | 'DELIVERY', required
      - `fee` union
        - object
          - `feeType` 'ORDER' | 'NETWORK' | 'SPREAD' | 'REBATE', required: The type of fee, such as ORDER, NETWORK, or SPREAD. ORDER - Fee for executing the order. NETWORK - Fee for network transactions. SPREAD - Fee for the difference between buy and sell prices. REBATE - Negative fee returned to the user as a reward or incentive.
          - `assetId` string, required: The asset identifier for the fee.
          - `amountType` 'FIXED', required: The type of amount for the fee, indicating a fixed amount.
          - `amount` string, required: The fixed amount of the fee
        - object
          - `feeType` 'ORDER' | 'NETWORK' | 'SPREAD' | 'REBATE', required: The type of fee, such as ORDER, NETWORK, or SPREAD. ORDER - Fee for executing the order. NETWORK - Fee for network transactions. SPREAD - Fee for the difference between buy and sell prices. REBATE - Negative fee returned to the user as a reward or incentive.
          - `assetId` string, required: The asset identifier for the fee.
          - `amountType` 'BPS', required
          - `amount` number, required: Fee in basis points (1 = 0.01%, 10000 = 100%)
    - `generalFees` Fee[]: General fees associated with the quote.
      - union
        - object
          - `feeType` 'ORDER' | 'NETWORK' | 'SPREAD' | 'REBATE', required: The type of fee, such as ORDER, NETWORK, or SPREAD. ORDER - Fee for executing the order. NETWORK - Fee for network transactions. SPREAD - Fee for the difference between buy and sell prices. REBATE - Negative fee returned to the user as a reward or incentive.
          - `assetId` string, required: The asset identifier for the fee.
          - `amountType` 'FIXED', required: The type of amount for the fee, indicating a fixed amount.
          - `amount` string, required: The fixed amount of the fee
        - object
          - `feeType` 'ORDER' | 'NETWORK' | 'SPREAD' | 'REBATE', required: The type of fee, such as ORDER, NETWORK, or SPREAD. ORDER - Fee for executing the order. NETWORK - Fee for network transactions. SPREAD - Fee for the difference between buy and sell prices. REBATE - Negative fee returned to the user as a reward or incentive.
          - `assetId` string, required: The asset identifier for the fee.
          - `amountType` 'BPS', required
          - `amount` number, required: Fee in basis points (1 = 0.01%, 10000 = 100%)
    - `side` 'BUY' | 'SELL', required: BUY: receive base / pay quote; SELL: give base / receive quote.
    - `expiresAt` string, required: The expiration time of the quote in ISO 8601 format, taken verbatim from the provider. This is not safety-margined by the server — integrators must apply their own margin if one is needed.
    - `requiredParticipantsIdentificationOnOrder` string: A JSON Schema Draft-7 document in string format describing the fields required when creating an order so clients can validate their order payload before sending.
    - `type` 'COMMITTED' | 'INDICATIVE', required: The type of the quote.
  - `quoteFailures` ScopeItemFailure[], required: List of partial failures encountered while requesting quotes. Empty when all quote attempts succeed.
    - `providerId` string, required: Identifier of the provider for which the request failed.
    - `accountId` string: Identifier of the account for which the request failed (optional).
    - `error` TradingErrorSchema, required
      - `message` string, required
      - `code` number, required
      - `descriptor` string

## Other responses

- `400`: Bad request: invalid input parameters, malformed request body, or validation failure.
- `401`: Unauthorized. Missing / invalid JWT token in Authorization header.
- `403`: Forbidden: insufficient permissions, disabled feature, or restricted access.
- `429`: Rate limit exceeded: slow down and retry later.
- `5XX`: Internal error while processing the request.
- `default`: Error Response

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)
