Get providers

Retrieve a list of all available external providers supporting trading activities through the platform.

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 CSM@fireblocks.com.

Endpoint Permission: Owner, Admin, Non-Signing Admin, Signer, Approver, Editor, Viewer.

For detailed information about error codes and troubleshooting, please refer to our API Error Codes documentation.

GET

trading

providers

TypeScript

const response: Promise<FireblocksResponse<ProvidersListResponse>> = fireblocks.tradingBeta.getTradingProviders(tradingBetaApiGetTradingProvidersRequest);

CompletableFuture<ApiResponse<ProvidersListResponse>> response = fireblocks.tradingBeta().getTradingProviders(pageSize, pageCursor);

response = fireblocks.trading_beta.get_trading_providers(page_size, page_cursor);

curl --request GET \
  --url https://api.fireblocks.io/v1/trading/providers

const options = {method: 'GET'};

fetch('https://api.fireblocks.io/v1/trading/providers', 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/providers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	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/providers")

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

request = Net::HTTP::Get.new(url)

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

{
  "data": [
    {
      "id": "BRIDGE",
      "name": "Bridge",
      "logo": "https://example.com/logos/bridge.png",
      "accountBased": true,
      "manifest": {
        "order": {
          "supported": true,
          "executionTypes": [
            "MARKET"
          ],
          "settlementTypes": [
            "DVP"
          ]
        },
        "quote": {
          "supported": false
        },
        "rate": {
          "supported": true
        }
      },
      "connected": true,
      "accounts": [
        {
          "id": "acc_5e9a2d1c4b7f3e8a",
          "name": "Main Trading Account"
        }
      ]
    },
    {
      "id": "UNISWAP_CLASSIC",
      "name": "Uniswap Classic",
      "logo": "https://example.com/logos/uniswap.png",
      "accountBased": false,
      "manifest": {
        "order": {
          "supported": true,
          "executionTypes": [
            "MARKET"
          ],
          "settlementTypes": [
            "PREFUNDED"
          ]
        },
        "quote": {
          "supported": false
        },
        "rate": {
          "supported": true
        }
      },
      "approved": true,
      "hasTermsOfService": true,
      "termsOfServiceUrl": "https://uniswap.org/terms"
    }
  ],
  "total": 2,
  "next": "cursor_abc123def456"
}

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

Query Parameters

pageSize

integer

default:20

Page size for pagination.

Required range: 1 <= x <= 100

pageCursor

string

Page cursor for pagination.

Response

Providers response

data

object[]

required

List of available providers

Provider integrated via Fireblocks connected accounts (accountBased is true).

Option 1
Option 2

Show child attributes

Example:

{
  "id": "BRIDGE",
  "name": "Bridge",
  "logo": "https://example.com/logos/bridge.png",
  "accountBased": true,
  "manifest": {
    "order": {
      "supported": true,
      "executionTypes": ["MARKET"],
      "settlementTypes": ["DVP"]
    },
    "quote": { "supported": false },
    "rate": { "supported": true }
  },
  "connected": true,
  "accounts": [
    {
      "id": "acc_5e9a2d1c4b7f3e8a",
      "name": "Main Trading Account"
    }
  ]
}

total

integer

required

Total number of providers matching the query.

string

A cursor for the next page of results, if available.

Get trading provider by IDRetrieve a single provider by ID. **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 CSM@fireblocks.com. **Endpoint Permission:** Owner, Admin, Non-Signing Admin, Signer, Approver, Editor, Viewer. For detailed information about error codes and troubleshooting, please refer to our [API Error Codes documentation](https://developers.fireblocks.com/reference/api-error-codes).

⌘I

TypeScript

const response: Promise<FireblocksResponse<ProvidersListResponse>> = fireblocks.tradingBeta.getTradingProviders(tradingBetaApiGetTradingProvidersRequest);

CompletableFuture<ApiResponse<ProvidersListResponse>> response = fireblocks.tradingBeta().getTradingProviders(pageSize, pageCursor);

response = fireblocks.trading_beta.get_trading_providers(page_size, page_cursor);

curl --request GET \
  --url https://api.fireblocks.io/v1/trading/providers

const options = {method: 'GET'};

fetch('https://api.fireblocks.io/v1/trading/providers', 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/providers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	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/providers")

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

request = Net::HTTP::Get.new(url)

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

{
  "data": [
    {
      "id": "BRIDGE",
      "name": "Bridge",
      "logo": "https://example.com/logos/bridge.png",
      "accountBased": true,
      "manifest": {
        "order": {
          "supported": true,
          "executionTypes": [
            "MARKET"
          ],
          "settlementTypes": [
            "DVP"
          ]
        },
        "quote": {
          "supported": false
        },
        "rate": {
          "supported": true
        }
      },
      "connected": true,
      "accounts": [
        {
          "id": "acc_5e9a2d1c4b7f3e8a",
          "name": "Main Trading Account"
        }
      ]
    },
    {
      "id": "UNISWAP_CLASSIC",
      "name": "Uniswap Classic",
      "logo": "https://example.com/logos/uniswap.png",
      "accountBased": false,
      "manifest": {
        "order": {
          "supported": true,
          "executionTypes": [
            "MARKET"
          ],
          "settlementTypes": [
            "PREFUNDED"
          ]
        },
        "quote": {
          "supported": false
        },
        "rate": {
          "supported": true
        }
      },
      "approved": true,
      "hasTermsOfService": true,
      "termsOfServiceUrl": "https://uniswap.org/terms"
    }
  ],
  "total": 2,
  "next": "cursor_abc123def456"
}

{
  "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 providers

Query Parameters

Response