Get trading provider by ID

Retrieve 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 [e-mail].

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/{providerId}

TypeScript

TypeScript

const response: Promise<FireblocksResponse<TradingProvider>> = fireblocks.tradingBeta.getTradingProviderById(tradingBetaApiGetTradingProviderByIdRequest);

200

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

Path Parameters

providerId · string · required

The unique identifier of the provider.

Minimum string length: 1

Response

200

application/json

Single provider details.

Option 1

Option 2

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

id · string · required

Unique identifier for the provider

name · string · required

Display name of the provider

accountBased · boolean · required

Indicates whether the provider access model is through accounts or directly

manifest · object · required

The manifest of the provider, describing its supported order, quote, and rate requirements.

Show child attributes

Example:

{
  "order": {
    "supported": true,
    "executionTypes": ["MARKET", "QUOTE"],
    "settlementTypes": ["DVP"]
  },
  "quote": {
    "supported": true,
    "settlementTypes": ["DVP"]
  },
  "rate": { "supported": true },
  "participantsIdentificationPolicy": {
    "supportedEndpoints": ["ORDER", "QUOTE"],
    "defaultSchema": "{\"$schema\":\"http://json-schema.org/draft-07/schema#\",\"type\":\"object\",\"required\":[\"originator\",\"beneficiary\"],\"properties\":{\"originator\":{\"type\":\"object\",\"required\":[\"entityType\"],\"oneOf\":[{\"properties\":{\"entityType\":{\"const\":\"INDIVIDUAL\"},\"fullName\":{\"type\":\"object\",\"required\":[\"firstName\",\"lastName\"],\"properties\":{\"firstName\":{\"type\":\"string\"},\"lastName\":{\"type\":\"string\"}}},\"email\":{\"type\":\"string\",\"format\":\"email\"}},\"required\":[\"entityType\",\"fullName\",\"email\"]},{\"properties\":{\"entityType\":{\"const\":\"BUSINESS\"},\"businessName\":{\"type\":\"string\"},\"email\":{\"type\":\"string\",\"format\":\"email\"}},\"required\":[\"entityType\",\"businessName\",\"email\"]}]},\"beneficiary\":{\"type\":\"object\",\"required\":[\"entityType\"],\"oneOf\":[{\"properties\":{\"entityType\":{\"const\":\"INDIVIDUAL\"},\"fullName\":{\"type\":\"object\",\"required\":[\"firstName\",\"lastName\"],\"properties\":{\"firstName\":{\"type\":\"string\"},\"lastName\":{\"type\":\"string\"}}}},\"required\":[\"entityType\",\"fullName\"]},{\"properties\":{\"entityType\":{\"const\":\"BUSINESS\"},\"businessName\":{\"type\":\"string\"}},\"required\":[\"entityType\",\"businessName\"]}]}}}"
  }
}

connected · boolean · required

Whether the provider is currently connected.

accounts · object[] · required

Show child attributes

logo · string

URL to the logo image of the provider