> ## Documentation Index > Fetch the complete documentation index at: https://developers.fireblocks.com/llms.txt > Use this file to discover all available pages before exploring further. # 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](https://developers.fireblocks.com/reference/api-error-codes). ## OpenAPI ````yaml https://docs.fireblocks.com/api/v1/swagger.yaml get /trading/providers openapi: 3.0.0 info: title: Fireblocks API description: > Fireblocks provides a suite of applications to manage digital asset operations and a complete development platform to build your business on the blockchain. - Visit our website for more information: [Fireblocks Website](https://fireblocks.com) - Visit our developer docs: [Fireblocks DevPortal](https://developers.fireblocks.com) version: 1.6.2 contact: email: developers@fireblocks.com servers: - url: https://api.fireblocks.io/v1 description: Fireblocks Production Environment Base URL - url: https://sandbox-api.fireblocks.io/v1 description: Fireblocks Sandbox Environment Base URL security: [] paths: /trading/providers: get: tags: - Trading (Beta) summary: Get providers description: > 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](https://developers.fireblocks.com/reference/api-error-codes). operationId: getTradingProviders parameters: - name: pageSize in: query required: false description: Page size for pagination. schema: type: integer minimum: 1 maximum: 100 default: 20 - name: pageCursor in: query required: false description: Page cursor for pagination. schema: type: string responses: '200': description: Providers response headers: X-Request-ID: $ref: '#/components/headers/X-Request-ID' content: application/json: schema: $ref: '#/components/schemas/ProvidersListResponse' '401': description: Unauthorized. Missing / invalid JWT token in Authorization header. headers: X-Request-ID: $ref: '#/components/headers/X-Request-ID' content: application/json: schema: $ref: '#/components/schemas/TradingErrorSchema' '403': description: >- Forbidden: insufficient permissions, disabled feature, or restricted access. headers: X-Request-ID: $ref: '#/components/headers/X-Request-ID' content: application/json: schema: $ref: '#/components/schemas/TradingErrorSchema' '429': description: 'Rate limit exceeded: slow down and retry later.' headers: X-Request-ID: $ref: '#/components/headers/X-Request-ID' content: application/json: schema: $ref: '#/components/schemas/TradingErrorSchema' 5XX: description: Internal error while processing the request. headers: X-Request-ID: $ref: '#/components/headers/X-Request-ID' content: application/json: schema: $ref: '#/components/schemas/TradingErrorSchema' default: $ref: '#/components/responses/Error' x-codeSamples: - lang: TypeScript source: >- const response: Promise> = fireblocks.tradingBeta.getTradingProviders(tradingBetaApiGetTradingProvidersRequest); - lang: Java source: >- CompletableFuture> response = fireblocks.tradingBeta().getTradingProviders(pageSize, pageCursor); - lang: Python source: >- response = fireblocks.trading_beta.get_trading_providers(page_size, page_cursor); components: headers: X-Request-ID: schema: type: string description: >- Unique ID correlated to the API request. Please provide it in any support ticket you create or on Github issues related to Fireblocks SDKs schemas: ProvidersListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/TradingProvider' description: List of available providers total: type: integer description: Total number of providers matching the query. next: type: string description: A cursor for the next page of results, if available. required: - data - total example: 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 TradingErrorSchema: type: object properties: message: type: string code: type: number descriptor: type: string required: - code - message example: code: 900 message: 'Invalid base amount: must be greater than 0' TradingProvider: oneOf: - $ref: '#/components/schemas/AccountBasedAccessProvider' - $ref: '#/components/schemas/DirectAccessProvider' ErrorSchema: type: object properties: message: type: string code: type: number AccountBasedAccessProvider: description: >- Provider integrated via Fireblocks connected accounts (`accountBased` is `true`). allOf: - $ref: '#/components/schemas/BaseProvider' - $ref: '#/components/schemas/AccountBasedAccessProviderInfo' 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 DirectAccessProvider: description: Provider used without per-account linking (`accountBased` is `false`). allOf: - $ref: '#/components/schemas/BaseProvider' - $ref: '#/components/schemas/DirectAccessProviderInfo' example: id: UNISWAP_CLASSIC name: Uniswap Classic logo: https://example.com/logos/uniswap.png accountBased: false manifest: order: supported: true executionTypes: - MARKET - QUOTE settlementTypes: - DVP quote: supported: true settlementTypes: - DVP rate: supported: true approved: true hasTermsOfService: true termsOfServiceUrl: https://uniswap.org/terms BaseProvider: type: object properties: id: type: string description: Unique identifier for the provider name: type: string description: Display name of the provider logo: type: string description: URL to the logo image of the provider accountBased: type: boolean description: >- Indicates whether the provider access model is through accounts or directly manifest: $ref: '#/components/schemas/Manifest' required: - id - name - accountBased - manifest AccountBasedAccessProviderInfo: type: object properties: connected: type: boolean description: Whether the provider is currently connected. accounts: type: array items: $ref: '#/components/schemas/AccountBase' required: - connected - accounts DirectAccessProviderInfo: type: object properties: approved: type: boolean description: Whether the provider was approved for use hasTermsOfService: type: boolean description: Whether the provider has terms of service termsOfServiceUrl: type: string description: URL to the terms of service document privacyPolicyUrl: type: string description: URL to the privacy policy document required: - hasTermsOfService Manifest: type: object description: >- The manifest of the provider, describing its supported order, quote, and rate requirements. properties: order: $ref: '#/components/schemas/ManifestOrder' quote: $ref: '#/components/schemas/ManifestQuote' rate: $ref: '#/components/schemas/ManifestBase' participantsIdentificationPolicy: $ref: '#/components/schemas/ParticipantsIdentificationPolicy' required: - order - quote - rate 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"]}]}}} AccountBase: type: object properties: id: type: string description: The ID of the account name: type: string description: The name of the account required: - id - name example: id: acc_9f4e2d8b1c6a5e73 name: Main Trading Account ManifestOrder: allOf: - $ref: '#/components/schemas/ManifestBase' - $ref: '#/components/schemas/ManifestOrderInfo' ManifestQuote: allOf: - $ref: '#/components/schemas/ManifestBase' - $ref: '#/components/schemas/ManifestQuoteInfo' ManifestBase: type: object description: Base manifest schema with common properties properties: supported: type: boolean description: Indicates whether the endpoint is supported by the provider required: - supported ParticipantsIdentificationPolicy: type: object description: > When present on a provider manifest, specifies KYC/AML identification requirements as JSON Schemas and which flows in `supportedEndpoints` may require `participantsIdentification`. Only endpoints listed in `supportedEndpoints` are in scope for this policy. `defaultSchema` is the baseline; `overrides` refine it by `asset`, `rail`, and/or `flowDirection` (see priority below). The most specific matching override applies its `schema` for that request context: it may fully replace `defaultSchema`, or partially override it—when the override `schema` is not provided as a complete standalone definition, fields and rules omitted there continue to follow `defaultSchema`. If this object is omitted from the manifest, the provider imposes no PII requirements through this policy. FirstParty participants are always exempt. Resolution: from overrides that match the request context, choose the most specific (most dimensions matched); break ties by earlier position in the `overrides` array; if none match, use `defaultSchema`. Priority (highest precedence first): 1. asset + rail + flowDirection 2. Any two dimensions: asset+rail, asset+flowDirection, rail+flowDirection 3. Any single dimension: asset, rail, or flowDirection 4. defaultSchema (no override matches) properties: supportedEndpoints: type: array description: > API endpoints in scope for this participants identification policy. Values `ORDER`, `QUOTE`, and `RATE` correspond to manifest `order`, `quote`, and `rate` flows. Client requests to those endpoints may need to include `participantsIdentification` when the resolved schema requires it. minItems: 1 uniqueItems: true items: $ref: '#/components/schemas/ParticipantsIdentificationSupportedEndpoint' defaultSchema: $ref: '#/components/schemas/ParticipantsIdentificationJsonSchema' overrides: type: array description: > Contextual overrides scoped by asset, rail, and/or flowDirection. Most specific match wins; ties broken by array order. Replaces the default partially. Each override MUST include at least one of `asset`, `rail`, or `flowDirection` (not `schema` alone); see IdentificationPolicyOverride. items: $ref: '#/components/schemas/IdentificationPolicyOverride' required: - supportedEndpoints - defaultSchema example: 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"]}]}}} overrides: - asset: NGN schema: >- {"$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"},"idNumber":{"type":"string"},"idType":{"type":"string","enum":["NIN_SLIP_CARD"]},"additionalIdNumber":{"type":"string"},"additionalIdType":{"type":"string","enum":["BVN"]}},"required":["entityType","fullName","email","idNumber","additionalIdNumber"]},{"properties":{"entityType":{"const":"BUSINESS"},"businessName":{"type":"string"},"email":{"type":"string","format":"email"},"registrationNumber":{"type":"string"}},"required":["entityType","businessName","email","registrationNumber"]}]},"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"]}]}}} - rail: MOMO schema: >- {"$schema":"http://json-schema.org/draft-07/schema#","type":"object","required":["originator"],"properties":{"originator":{"type":"object","required":["entityType"],"oneOf":[{"properties":{"entityType":{"const":"INDIVIDUAL"},"fullName":{"type":"object","required":["firstName"],"properties":{"firstName":{"type":"string"}}},"phone":{"type":"string"}},"required":["entityType","fullName","phone"]}]}}} - asset: NGN rail: MOMO schema: >- {"$schema":"http://json-schema.org/draft-07/schema#","type":"object","required":["originator"],"properties":{"originator":{"type":"object","required":["entityType"],"oneOf":[{"properties":{"entityType":{"const":"INDIVIDUAL"},"fullName":{"type":"object","required":["firstName"],"properties":{"firstName":{"type":"string"}}},"phone":{"type":"string"},"idNumber":{"type":"string"},"idType":{"type":"string","enum":["NIN_SLIP_CARD"]}},"required":["entityType","fullName","phone","idNumber"]}]}}} ManifestOrderInfo: type: object description: Defines requirements for the POST /orders endpoint. properties: settlementTypes: type: array description: > Supported settlement types when creating an order. If present - settlement is required. If absent - no need to provide settlement. items: $ref: '#/components/schemas/SettlementTypeEnum' executionTypes: type: array description: Supported execution types when creating an order. items: $ref: '#/components/schemas/ExecutionRequestDetailsType' required: - executionTypes ManifestQuoteInfo: type: object description: Defines requirements for the POST /quotes endpoint. properties: settlementTypes: type: array description: > Supported settlement types when requesting a quote. If present - settlement is required. If absent - no need to provide settlement. items: $ref: '#/components/schemas/DVPSettlementType' ParticipantsIdentificationSupportedEndpoint: type: string description: > Trading API endpoint category where `participantsIdentification` may be required when this policy is present. Corresponds to manifest `order`, `quote`, and `rate`: ORDER, QUOTE, and RATE respectively. enum: - ORDER - QUOTE - RATE ParticipantsIdentificationJsonSchema: type: string description: > A JSON Schema (draft-07) in string format that validates the ParticipantsIdentification object on requests where the provider manifest lists that endpoint in `participantsIdentificationPolicy.supportedEndpoints` (e.g. POST /orders). Defines which fields from originator and/or beneficiary are required. The schema uses oneOf to discriminate between INDIVIDUAL (PersonalIdentification) and BUSINESS (BusinessIdentification) entity types for each participant. For INDIVIDUAL: fullName, dateOfBirth, postalAddress, email, phone, idNumber, idType, etc. For BUSINESS: businessName, registrationNumber, postalAddress, email, phone, etc. If you constrain `idType` or `additionalIdType` with a JSON Schema `enum`, use the same values as `PersonalIdentificationType` (authoritative list in that schema). The example below mirrors that enum. The string content is expected to be valid JSON (application/json). example: | { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "required": ["originator"], "properties": { "originator": { "type": "object", "required": ["entityType"], "oneOf": [ { "properties": { "entityType": { "const": "INDIVIDUAL" }, "fullName": { "type": "object", "required": ["firstName", "lastName"], "properties": { "firstName": { "type": "string" }, "lastName": { "type": "string" }, "middleName": { "type": "string" } } }, "dateOfBirth": { "type": "string", "format": "date" }, "email": { "type": "string", "format": "email" }, "phone": { "type": "string", "pattern": "^\\+[1-9]\\d{1,14}$" }, "postalAddress": { "type": "object", "required": ["city", "country"], "properties": { "streetLine1": { "type": "string" }, "streetLine2": { "type": "string" }, "city": { "type": "string" }, "region": { "type": "string" }, "postalCode": { "type": "string" }, "country": { "type": "string" } } }, "idNumber": { "type": "string" }, "idType": { "type": "string", "enum": ["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"] } }, "required": ["entityType", "fullName", "email", "postalAddress"] }, { "properties": { "entityType": { "const": "BUSINESS" }, "businessName": { "type": "string" }, "registrationNumber": { "type": "string" }, "email": { "type": "string", "format": "email" }, "phone": { "type": "string", "pattern": "^\\+[1-9]\\d{1,14}$" }, "postalAddress": { "type": "object", "required": ["city", "country"], "properties": { "streetLine1": { "type": "string" }, "streetLine2": { "type": "string" }, "city": { "type": "string" }, "region": { "type": "string" }, "postalCode": { "type": "string" }, "country": { "type": "string" } } } }, "required": ["entityType", "businessName", "postalAddress"] } ] }, "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"] } ] } } } IdentificationPolicyOverride: type: object description: > Override scoped by one or more dimensions. More dimensions = higher priority. Equal priority ties are broken by array order. **Validation:** At least one of `asset`, `rail`, or `flowDirection` will be present. Priority (highest to lowest): 1. asset + rail + flowDirection 2. asset + rail 2. asset + flowDirection 2. rail + flowDirection 3. asset only 3. rail only 3. flowDirection only 4. defaultSchema (no override matched) properties: asset: type: string description: Fireblocks asset ID (fiat or crypto). rail: $ref: '#/components/schemas/TransferRail' flowDirection: $ref: '#/components/schemas/FlowDirection' schema: $ref: '#/components/schemas/ParticipantsIdentificationJsonSchema' required: - schema SettlementTypeEnum: type: string enum: - DVP - PREFUNDED description: Settlement type supported by the provider ExecutionRequestDetailsType: type: string enum: - QUOTE - MARKET description: Execution type supported by the provider DVPSettlementType: type: string enum: - DVP TransferRail: type: string description: > 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 enum: - BLOCKCHAIN - INTERNAL - SWIFT - IBAN - US_WIRE - ACH - SEPA - SPEI - PIX - LBT - MOMO - CHAPS - PAYID - INTERAC - INTERNAL_TRANSFER example: BLOCKCHAIN FlowDirection: type: string description: The direction of asset conversion in an order. enum: - FIAT_TO_CRYPTO - CRYPTO_TO_FIAT - CRYPTO_TO_CRYPTO - FIAT_TO_FIAT responses: Error: description: Error Response headers: X-Request-ID: $ref: '#/components/headers/X-Request-ID' content: application/json: schema: $ref: '#/components/schemas/ErrorSchema' ````