Get all offers

Retrieve all available offers across the workspace for a given asset pair. Always operates in open scope — no provider or account selection required. Returns a mix of indicative rates and committed quotes as applicable per provider.

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

If no slippageBps is provided, it defaults to 50 bps (0.5%). Slippage and settlement configuration do not affect the returned rate.

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

offers

TypeScript

const response: Promise<FireblocksResponse<OffersResponse>> = fireblocks.trading.fetchAllOffers(tradingApiFetchAllOffersRequest);

curl --request POST \
  --url https://api.fireblocks.io/v1/trading/offers \
  --header 'Content-Type: application/json' \
  --data '
{
  "baseAssetId": "BTC",
  "quoteAssetId": "USD",
  "baseAmount": "100.00",
  "baseAssetRail": "BLOCKCHAIN",
  "quoteAssetRail": "BLOCKCHAIN",
  "slippageBps": 50,
  "settlement": {
    "type": "DVP",
    "sourceAccount": {
      "type": "VAULT_ACCOUNT",
      "id": "vault_acc_3f7e1d9b2c5a8e4f"
    },
    "destinationAccount": {
      "type": "VAULT_ACCOUNT",
      "id": "vault_acc_7b2e5d8f1c4a9e3b"
    }
  },
  "side": "SELL"
}
'

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    baseAssetId: 'BTC',
    quoteAssetId: 'USD',
    baseAmount: '100.00',
    baseAssetRail: 'BLOCKCHAIN',
    quoteAssetRail: 'BLOCKCHAIN',
    slippageBps: 50,
    settlement: {
      type: 'DVP',
      sourceAccount: {type: 'VAULT_ACCOUNT', id: 'vault_acc_3f7e1d9b2c5a8e4f'},
      destinationAccount: {type: 'VAULT_ACCOUNT', id: 'vault_acc_7b2e5d8f1c4a9e3b'}
    },
    side: 'SELL'
  })
};

fetch('https://api.fireblocks.io/v1/trading/offers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fireblocks.io/v1/trading/offers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'baseAssetId' => 'BTC',
    'quoteAssetId' => 'USD',
    'baseAmount' => '100.00',
    'baseAssetRail' => 'BLOCKCHAIN',
    'quoteAssetRail' => 'BLOCKCHAIN',
    'slippageBps' => 50,
    'settlement' => [
        'type' => 'DVP',
        'sourceAccount' => [
                'type' => 'VAULT_ACCOUNT',
                'id' => 'vault_acc_3f7e1d9b2c5a8e4f'
        ],
        'destinationAccount' => [
                'type' => 'VAULT_ACCOUNT',
                'id' => 'vault_acc_7b2e5d8f1c4a9e3b'
        ]
    ],
    'side' => 'SELL'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fireblocks.io/v1/trading/offers"

	payload := strings.NewReader("{\n  \"baseAssetId\": \"BTC\",\n  \"quoteAssetId\": \"USD\",\n  \"baseAmount\": \"100.00\",\n  \"baseAssetRail\": \"BLOCKCHAIN\",\n  \"quoteAssetRail\": \"BLOCKCHAIN\",\n  \"slippageBps\": 50,\n  \"settlement\": {\n    \"type\": \"DVP\",\n    \"sourceAccount\": {\n      \"type\": \"VAULT_ACCOUNT\",\n      \"id\": \"vault_acc_3f7e1d9b2c5a8e4f\"\n    },\n    \"destinationAccount\": {\n      \"type\": \"VAULT_ACCOUNT\",\n      \"id\": \"vault_acc_7b2e5d8f1c4a9e3b\"\n    }\n  },\n  \"side\": \"SELL\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fireblocks.io/v1/trading/offers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"baseAssetId\": \"BTC\",\n  \"quoteAssetId\": \"USD\",\n  \"baseAmount\": \"100.00\",\n  \"baseAssetRail\": \"BLOCKCHAIN\",\n  \"quoteAssetRail\": \"BLOCKCHAIN\",\n  \"slippageBps\": 50,\n  \"settlement\": {\n    \"type\": \"DVP\",\n    \"sourceAccount\": {\n      \"type\": \"VAULT_ACCOUNT\",\n      \"id\": \"vault_acc_3f7e1d9b2c5a8e4f\"\n    },\n    \"destinationAccount\": {\n      \"type\": \"VAULT_ACCOUNT\",\n      \"id\": \"vault_acc_7b2e5d8f1c4a9e3b\"\n    }\n  },\n  \"side\": \"SELL\"\n}"

response = http.request(request)
puts response.read_body

{
  "offers": [
    {
      "via": {
        "type": "PROVIDER_ACCOUNT",
        "providerId": "uniswap-v3-provider",
        "accountId": "account-123"
      },
      "baseAssetId": "<string>",
      "quoteAssetId": "<string>",
      "rate": "1.2345",
      "offerType": "RATE",
      "baseAssetRail": "BLOCKCHAIN",
      "quoteAssetRail": "BLOCKCHAIN",
      "side": "BUY"
    }
  ],
  "errors": [
    {
      "providerId": "BRIDGE",
      "error": {
        "code": 900,
        "message": "Invalid base amount: must be greater than 0"
      },
      "accountId": "acc_9f4e2d8b1c6a5e73"
    }
  ]
}

{
  "code": 900,
  "message": "Invalid base amount: must be greater than 0"
}

{
  "code": 900,
  "message": "Invalid base amount: must be greater than 0"
}

{
  "code": 900,
  "message": "Invalid base amount: must be greater than 0"
}

{
  "code": 900,
  "message": "Invalid base amount: must be greater than 0"
}

{
  "code": 900,
  "message": "Invalid base amount: must be greater than 0"
}

{
  "message": "<string>",
  "code": 123
}

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"

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

Available options:

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

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

Available options:

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

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)

Show child attributes

Example:

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

side

enum<string>

default:SELL

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.

Available options:

BUY,

SELL,

BOTH

Response

Offers response

offers

object[]

required

List of offers returned for the requested asset pair.

Option 1
Option 2

Show child attributes

errors

object[]

required

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

Show child attributes

⌘I

TypeScript

const response: Promise<FireblocksResponse<OffersResponse>> = fireblocks.trading.fetchAllOffers(tradingApiFetchAllOffersRequest);

curl --request POST \
  --url https://api.fireblocks.io/v1/trading/offers \
  --header 'Content-Type: application/json' \
  --data '
{
  "baseAssetId": "BTC",
  "quoteAssetId": "USD",
  "baseAmount": "100.00",
  "baseAssetRail": "BLOCKCHAIN",
  "quoteAssetRail": "BLOCKCHAIN",
  "slippageBps": 50,
  "settlement": {
    "type": "DVP",
    "sourceAccount": {
      "type": "VAULT_ACCOUNT",
      "id": "vault_acc_3f7e1d9b2c5a8e4f"
    },
    "destinationAccount": {
      "type": "VAULT_ACCOUNT",
      "id": "vault_acc_7b2e5d8f1c4a9e3b"
    }
  },
  "side": "SELL"
}
'

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    baseAssetId: 'BTC',
    quoteAssetId: 'USD',
    baseAmount: '100.00',
    baseAssetRail: 'BLOCKCHAIN',
    quoteAssetRail: 'BLOCKCHAIN',
    slippageBps: 50,
    settlement: {
      type: 'DVP',
      sourceAccount: {type: 'VAULT_ACCOUNT', id: 'vault_acc_3f7e1d9b2c5a8e4f'},
      destinationAccount: {type: 'VAULT_ACCOUNT', id: 'vault_acc_7b2e5d8f1c4a9e3b'}
    },
    side: 'SELL'
  })
};

fetch('https://api.fireblocks.io/v1/trading/offers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fireblocks.io/v1/trading/offers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'baseAssetId' => 'BTC',
    'quoteAssetId' => 'USD',
    'baseAmount' => '100.00',
    'baseAssetRail' => 'BLOCKCHAIN',
    'quoteAssetRail' => 'BLOCKCHAIN',
    'slippageBps' => 50,
    'settlement' => [
        'type' => 'DVP',
        'sourceAccount' => [
                'type' => 'VAULT_ACCOUNT',
                'id' => 'vault_acc_3f7e1d9b2c5a8e4f'
        ],
        'destinationAccount' => [
                'type' => 'VAULT_ACCOUNT',
                'id' => 'vault_acc_7b2e5d8f1c4a9e3b'
        ]
    ],
    'side' => 'SELL'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fireblocks.io/v1/trading/offers"

	payload := strings.NewReader("{\n  \"baseAssetId\": \"BTC\",\n  \"quoteAssetId\": \"USD\",\n  \"baseAmount\": \"100.00\",\n  \"baseAssetRail\": \"BLOCKCHAIN\",\n  \"quoteAssetRail\": \"BLOCKCHAIN\",\n  \"slippageBps\": 50,\n  \"settlement\": {\n    \"type\": \"DVP\",\n    \"sourceAccount\": {\n      \"type\": \"VAULT_ACCOUNT\",\n      \"id\": \"vault_acc_3f7e1d9b2c5a8e4f\"\n    },\n    \"destinationAccount\": {\n      \"type\": \"VAULT_ACCOUNT\",\n      \"id\": \"vault_acc_7b2e5d8f1c4a9e3b\"\n    }\n  },\n  \"side\": \"SELL\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fireblocks.io/v1/trading/offers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"baseAssetId\": \"BTC\",\n  \"quoteAssetId\": \"USD\",\n  \"baseAmount\": \"100.00\",\n  \"baseAssetRail\": \"BLOCKCHAIN\",\n  \"quoteAssetRail\": \"BLOCKCHAIN\",\n  \"slippageBps\": 50,\n  \"settlement\": {\n    \"type\": \"DVP\",\n    \"sourceAccount\": {\n      \"type\": \"VAULT_ACCOUNT\",\n      \"id\": \"vault_acc_3f7e1d9b2c5a8e4f\"\n    },\n    \"destinationAccount\": {\n      \"type\": \"VAULT_ACCOUNT\",\n      \"id\": \"vault_acc_7b2e5d8f1c4a9e3b\"\n    }\n  },\n  \"side\": \"SELL\"\n}"

response = http.request(request)
puts response.read_body

{
  "offers": [
    {
      "via": {
        "type": "PROVIDER_ACCOUNT",
        "providerId": "uniswap-v3-provider",
        "accountId": "account-123"
      },
      "baseAssetId": "<string>",
      "quoteAssetId": "<string>",
      "rate": "1.2345",
      "offerType": "RATE",
      "baseAssetRail": "BLOCKCHAIN",
      "quoteAssetRail": "BLOCKCHAIN",
      "side": "BUY"
    }
  ],
  "errors": [
    {
      "providerId": "BRIDGE",
      "error": {
        "code": 900,
        "message": "Invalid base amount: must be greater than 0"
      },
      "accountId": "acc_9f4e2d8b1c6a5e73"
    }
  ]
}

{
  "code": 900,
  "message": "Invalid base amount: must be greater than 0"
}

{
  "code": 900,
  "message": "Invalid base amount: must be greater than 0"
}

{
  "code": 900,
  "message": "Invalid base amount: must be greater than 0"
}

{
  "code": 900,
  "message": "Invalid base amount: must be greater than 0"
}

{
  "code": 900,
  "message": "Invalid base amount: must be greater than 0"
}

{
  "message": "<string>",
  "code": 123
}

Introduction

Errors & Statuses

Data Objects

API Endpoints

Get all offers

Headers

Body

Response