Skip to main content
POST
/
trading
/
offers
TypeScript
const response: Promise<FireblocksResponse<OffersResponse>> = fireblocks.tradingBeta.fetchAllOffers(tradingBetaApiFetchAllOffersRequest);
{
  "offers": [
    {
      "via": {
        "type": "PROVIDER_ACCOUNT",
        "providerId": "bridge-provider-001",
        "accountId": "acc_9f4e2d8b1c6a5e73"
      },
      "baseAssetId": "<string>",
      "quoteAssetId": "<string>",
      "rate": "1.2345",
      "offerType": "RATE",
      "baseAssetRail": "BLOCKCHAIN",
      "quoteAssetRail": "BLOCKCHAIN"
    }
  ],
  "errors": [
    {
      "providerId": "BRIDGE",
      "error": {
        "code": 900,
        "message": "Invalid base amount: must be greater than 0"
      },
      "accountId": "acc_9f4e2d8b1c6a5e73"
    }
  ]
}

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
​
baseAssetId
string
required

The source asset identifier.

Example:

"BTC"

​
quoteAssetId
string
required

The target asset identifier.

Example:

"USD"

​
baseAmount
string
required

The amount to get offers for

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
integer
default:50

Slippage tolerance in basis points (bps) for defi quotes - 1 is 0.01% and 10000 is 100%. If not set, defaults to 50 bps (0.5%).

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"
  }
}

Response

Offers response

​
offers
object[]
required

List of offers returned for the requested asset pair.

​
errors
object[]
required

Partial failures encountered while requesting offers. Empty when all offer requests succeed.