Exchanges

Overview

The Exchange module provides the infrastructure to carry out asset exchanges on behalf of customers —a particularly important feature for platforms that accommodate multiple asset types and currencies. This module includes a series of endpoints tailored to the needs of users looking to perform, monitor, and manage asset exchanges for their customers.

Offering functions from quoting to execution, along with detailed tracking mechanisms, the Exchange module endpoints include:

Get Available Asset Pairs: Provides a full list of asset pairs enabled for the API user. The response will also include information on limits and minimums associated with each asset pair for exchanges.
Get Quote for Exchange: Provides an estimate for an exchange, detailing the price and amount before the actual exchange is executed, ensuring that the customer is informed about the potential transaction.
Sell Exchange: Enables a customer to sell an asset, converting it into another asset or currency as specified in the trade.
Buy Exchange: Allows a customer to purchase an asset, facilitating the exchange through a defined asset pair and desired quantity.
List Exchanges: Provides a generated list of asset exchanges, with the ability to filter by customer, order type, and more.

Overall, the Exchange module is designed to offer a seamless and secure experience for handling the exchange requirements of customers, ensuring that users can manage these operations effectively with great precision and control.

Get Available Asset Pairs

Provides a full list of asset pairs enabled for the API user. The response will also include information on limits and minimums associated with each asset pair for exchanges.

Endpoint: /api/v1/customer/crypto-exchanges/availablepairs
Method: GET

Get available asset pairs

Request query:

PageNumber: list page number (optional, default = 1)
PageSize: list page size (optional, default = 10)

Response:

array of
- AssetPair: Asset pair code
- CommissionFeePercentage: exchange commission fee
- MaxTradeAmount: maximum trade amount in base asset
- MinTradeAmount: minimum trade amount in base asset
- MaxTradePrice: maximum trade price in quote asset
- MinTradePrice: minimum trade price in quote asset
- MaxDecimalPrecision: maximum allowed decimal precision when specifying price and amount

GEThttp://public-api.ibanera.com/api/v1/customer/crypto-exchanges/availablepairs

Query parameters

Header parameters

Response

Success

Body

statusnullable string

errorsnullable array of AvamaeTemplate.Core.Types.Results.Base.ErrorResultDto (object)

idinteger (int64)

detailsnullable array of AvamaeTemplate.Core.Types.Dtos.CustomerRole.CryptoExchangesModule.AssetPairDto (object)

pageSizenullable integer (int32)

pageNumbernullable integer (int32)

numberOfPagesnullable integer (int32)

Request

const response = await fetch('http://public-api.ibanera.com/api/v1/customer/crypto-exchanges/availablepairs', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "status": "text",
  "errors": [
    {
      "fieldName": "text",
      "messageCode": "text"
    }
  ],
  "details": [
    {
      "assetPair": "text",
      "commissionFeePercentage": 0,
      "productSetter": 0,
      "product": 0,
      "maxTradeAmount": 0,
      "minTradeAmount": 0,
      "maxTradePrice": 0,
      "minTradePrice": 0,
      "feeRates": [
        {
          "feeIncurringAction": "text",
          "percentageFee": 0,
          "minFee": 0,
          "fixedAdditionalFee": 0
        }
      ]
    }
  ]
}

Get Quote for Exchange

This endpoint provides a quoted market price for a proposed asset exchange for a particular customer, detailing the amount and price for either a "Buy" or "Sell" exchange type. By specifying details of the desired trade, a customer can see the cost or proceeds they might expect from completing a transaction, including any applicable fees. This helps customers decide whether to proceed with an exchange based on real-time financial data. Sell exchanges generally refer to converting a cryptocurrency into a fiat currency.

Endpoint: /api/v1/customer/crypto-exchanges/quote
Method: POST

Get quote for an exchange

Request Body:

CustomersId: Customer's Id
AssetPair: Asset pair to trade
ExchangeType: Type of exchange (possible values: Buy, Sell)
QuantityType: Quantity type indicating whether price or amount is fixed (possible values: Price, Amount)
Amount: Amount to request to trade (required if QuantityType = Amount)
Price: Price to request to trade for (required if QuantityType = Price)
PayeesId: If receiving account is a passthrough account, receiving payee's Id

Response:

CustomersId: Customer's Id
AssetPair: Asset pair to trade
QuantityType: Quantity type indicating whether price or amount is fixed (possible values: Price, Amount)
Amount: Amount to request to trade
NetPrice: Exchange effective net price accounting for commission and network fees
NetworkFee: Estimated exchange network fee
CommissionFee: Exchange commission fee
Price: Price to request to trade for
PayeesId: If receiving account is a passthrough account, receiving payee's Id (optional)
FxRateId: FX rate ID that’s to be used for sell endpoint
FxRateExpiryDate: FX rate ID expiry date

Possible validation errors:

Required
Invalid
Price_Too_Low (specified price lower than minimum allowed)
Amount_Too_Low (specified amount lower than minimum allowed)
Price_Too_High (specified price higher than maximum allowed)
Amount_Too_High (specified amount highter than maximum allowed)
Insufficient_Customer_Balance (customer does not have sufficient balance for exchange)

POSThttp://public-api.ibanera.com/api/v1/customer/crypto-exchanges/quote

Header parameters

Body

customersIdinteger (int32)

payeesIdnullable integer (int32)

assetPairnullable string

exchangeTypeAvamaeTemplate.Core.Enums.AssetExchangeTypes (enum)

quantityTypeAvamaeTemplate.Core.Enums.ExchangeQuantityTypes (enum)

transferTypeAvamaeTemplate.Core.Enums.TransferTypes (enum)

01234

amountnullable number (double)

pricenullable number (double)

Response

Success

Body

statusnullable string

errorsnullable array of AvamaeTemplate.Core.Types.Results.Base.ErrorResultDto (object)

idinteger (int64)

detailsAvamaeTemplate.Core.Types.Dtos.CustomerRole.CryptoExchangesModule.QuoteResultDto (object)

Request

const response = await fetch('http://public-api.ibanera.com/api/v1/customer/crypto-exchanges/quote', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json-patch+json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "status": "text",
  "errors": [
    {
      "fieldName": "text",
      "messageCode": "text"
    }
  ],
  "details": {
    "quantityType": 0,
    "assetPair": "text",
    "amount": 0,
    "netPrice": 0,
    "networkFee": 0,
    "commissionFee": 0,
    "price": 0,
    "fxRateExpiryDate": "2024-05-09T17:10:50.894Z"
  }
}

Request Body Parameters:

customersId (Integer): ID of the customer making the exchange—required.
payeesId (Integer, Nullable): Id of receiving payee, if receiving account is a passthrough account.
assetPair (String): The pair of assets to be exchanged, such as "BTC/USDC"—required.
quantityType (String): Defines if the exchange is based on "Price" or "Amount"—required.
exchangeType (String): Either "Buy" or "Sell"—required.
transferType (String): The transfer type, such as "Wire"—required.
- transferType is only required for sell exchanges where the “payeesId” is not null.
price (Decimal, Nullable): Desired price for a "Price"-based exchange, null for "Amount"-based.
amount (Decimal, Nullable): Desired amount for an "Amount"-based exchange, null for "Price"-based.

Request Example:

{
  "customersId": 1004,
  "assetPair": "BTC/USDC",
  "quantityType": "Price",
  "exchangeType": "Buy",
  "transferType": "Wire",
  "price": 10,
  "amount": null
}

Response Body Parameters:

id (Integer): Not used.
details (Object): Contains the quote details.
- customersId (Integer): ID of the customer.
- payeesId (Integer): The payee's ID to where the asset's sale proceeds will be credited. Required if receiving account is a passthrough account.
- quantityType (String): Indicates whether "Amount" or "Price" is fixed for the exchange exchange.
- assetPair (String): Asset pair involved in the exchange.
- amount (Decimal): Amount of asset to be exchanged.
- netPrice (Decimal): Exchange effective net price accounting for commission and network fees.
- networkFee (Decimal): Estimated exchange network fee.
- commissionFee (Decimal): The commission fee for the exchange.
- price (Decimal): Total quoted price for the exchange.
- fxRateId (Integer): FX rate ID that's to be used to for sell exchanges.
- fxRateExpiryDate (ISO 8601): Expire date for given fxRateId. Once the current time is greater than the expire time, you must generate a new quote.

Success Response Example:

{
    "id": 0,
    "details": {
        "customersId": 1004, 
        "payeesId": null, 
        "quantityType": "Price", 
        "assetPair": "BTC/USDC", 
        "amount": 0.00037578, 
        "netPrice": 8.79938276, 
        "networkFee": 1.15086600, 
        "commissionFee": 0.04975124, 
        "price": 10.0,
        "fxRateId": 1234, 
        "fxRateExpiryDate": "2022-12-06T15:23:47.838+00:00"
    },
    "status": "1",
    "errors": []
}

Possible Error Codes

Error Message Code	Description
Required	Named field missing or zero
Invalid	Value given for named field is invalid
Documents_Not_Verified	Cannot perform this action for this customer due to the KYC state
Amount_Must_Be_Positive	Invalid or missing amount

Error Message Code

Description

Required

Named field missing or zero

Invalid

Value given for named field is invalid

Documents_Not_Verified

Cannot perform this action for this customer due to the KYC state

Amount_Must_Be_Positive

Invalid or missing amount

Sell Exchange

This endpoint is designed to initiate a sell exchange, allowing a customer to sell an asset at a given price or for a specific amount.

Endpoint: /api/v1/customer/crypto-exchanges/sell
Method: POST

Initiate a sell exchange

Request Body:

CustomersId: Customer's Id
AssetPair: Asset pair to trade
QuantityType: Quantity type indicating whether price or amount is fixed (possible values: Price, Amount)
Amount: Amount to request to trade
Price: Price to request to trade for
PayeesId: If receiving account is a passthrough account, receiving payee's Id (optional)
TransferType: If receiving account is a passthrough account, type of transfer from passthrough account to payee (optional) (possible values: Wire, ACH)
FxRateId: Rate Id corresponding to the rate that's to be used for the sell exchange (FX only)
PurposeCode: Reason code for the transfer to the payee (required for foreign exchanges). E.g. 'PUC001'

Response:

Id: Exhcange Id
ExchangeType: Exchange type (possible values: Buy, Sell)
Status: Exchange status (possible values: WaitingForApproval, Rejected, WaitingForConfirmation, AwaitingRfi, Pending, Completed, Failed)
FromTransactionsId: Associated exchange transaction from debited managee asset account
ToTransactionsId: Associated exchange transaction to credited managee asset account
CustomersId: Customer's Id
AssetPair: Asset pair
RequestAmount: Amount requested
RequestPrice: Price requested
ExecutedAmount: Amount executed
ExecutedPrice: Price executed
CommissionFee: Commission fee
PayeesId: If receiving account is a passthrough account, receiving payee's Id
TransferType: If receiving account is a passthrough account, type of transfer from passthrough account to payee (possible values: Wire, ACH)
bHasOpenRfi: Flag indicating if request for information is pending to be submitted (FX only)

Possible validation errors:

Required
Invalid
Price_Too_Low (specified price lower than minimum allowed)
Amount_Too_Low (specified amount lower than minimum allowed)
Price_Too_High (specified price higher than maximum allowed)
Amount_Too_High (specified amount highter than maximum allowed)
Screening_Failed (transfer to an external payee screening failed, exchange not permitted)
Insufficient_Customer_Balance (managee does not have sufficient balance for exchange)
Price_Updated (Asset price has updated, exchange cannot be executed at requested price)

POSThttp://public-api.ibanera.com/api/v1/customer/crypto-exchanges/sell

Header parameters

Body

customersIdinteger (int32)

payeesIdnullable integer (int32)

assetPairnullable string

quantityTypeAvamaeTemplate.Core.Enums.ExchangeQuantityTypes (enum)

amountnullable number (double)

pricenullable number (double)

fxRateIdnullable integer (int32)

transferTypeAvamaeTemplate.Core.Enums.TransferTypes (enum)

01234

purposeCodenullable string

Response

Success

Body

statusnullable string

errorsnullable array of AvamaeTemplate.Core.Types.Results.Base.ErrorResultDto (object)

idinteger (int64)

detailsAvamaeTemplate.Core.Types.Dtos.CustomerRole.CryptoExchangesModule.AssetExchangeDto (object)

Request

const response = await fetch('http://public-api.ibanera.com/api/v1/customer/crypto-exchanges/sell', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json-patch+json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "status": "text",
  "errors": [
    {
      "fieldName": "text",
      "messageCode": "text"
    }
  ],
  "details": {
    "exchangeType": 0,
    "status": 0,
    "assetPair": "text",
    "requestAmount": 0,
    "requestPrice": 0,
    "executedAmount": 0,
    "executedPrice": 0,
    "commissionFee": 0,
    "transferType": 0,
    "bHasOpenRfi": false
  }
}

Request Body Parameters:

customersId (Integer): The customer's ID who owns the asset to be sold—required.
assetPair (String): The pair of assets involved in the exchange, such as "BTC/USD"—required.
TransferType (String): The type of transfer to be used (e.g., "Wire")—required.
fxRateId (String, Nullable): The FX rate ID to be used for the sell exchange, if applicable.
QuantityType (String): Specifies if the quote is for an "Amount" or "Price". Required if fxRateId is not provided.
amount (Decimal): The amount of asset to be sold, if QuantityType is "Amount". Amount or Price required if fxRateId is not provided - Required if quantityType is "Amount".
price (Decimal): The price at which the asset is to be sold, if QuantityType is "Price". Amount or Price required if fxRateId is not provided - Required if quantityType is "Price".
payeesId (Integer): The payee's ID to where the asset's sale proceeds will be credited. Required if receiving account is a passthrough account.
PurposeCode (String, Nullable): A code that signifies the reason for the transaction, for regulatory or record-keeping purposes. Required for FX sell orders. See the purpose code reference.

Request Body Example:

{
    "CustomersId": 1004,
    "PayeesId": 1011,
    "FxRateId": null,
    "AssetPair": "BTC/USD",
    "QuantityType": "Price",
    "TransferType": "Wire",
    "Price": 100,
    "Amount": 0.004,
    "PurposeCode": null
}

Response Body Parameters:

id (Integer): Not used.
details (Object):
- id (Integer): A unique identifier for this sell exchange transaction.
- exchangeType (String): Will show as "Sell" for most cases. .
- status (String): The current status of the sell exchange (e.g., "Pending").
- fromTransactionsId (Integer): Linked from transaction ID.
- toTransactionsId (Integer, Nullable): Linked to transaction ID.
- customersId (Integer): The customer's ID.
- assetPair (String): The asset pair involved in the exchange.
- requestAmount (Decimal): The amount requested to sell.
- requestPrice (Decimal): The price requested for the sale.
- executedAmount (Decimal, Nullable): The amount that was executed in the sale.
- executedPrice (Decimal, Nullable): The price at which the sale was executed.
- commissionFee (Decimal): The commission fee for the transaction.
- payeesId (Integer): The ID of the payee's account where the proceeds will be credited.
- transferType (String): The type of transfer from the asset account to the payee.
- bHasOpenRfi (Boolean): Indicates whether there is an open request for information (relevant for FX only).

Success Response Example:

{
        "id": 0,
        "details": {
            "id": 23304,
            "exchangeType": "Sell",
            "status": "WaitingForApproval",
            "fromTransactionsId": 3410,
            "toTransactionsId": 3409,
            "customersId": 1004,
            "assetPair": "BTC/USDC",
            "requestAmount": 0.004,
            "requestPrice": 100.0,
            "executedAmount": 0.00415,
            "executedPrice": 100.0,
            "commissionFee": 1.50,
            "payeesId": 1011,
            "transferType": "Wire",
            "bHasOpenRfi": false
        },
        "status": "1",
        "errors": []
}

Possible Error Codes

Error Message Code	Description
Required	Named field missing or zero
Invalid	Value given for named field is invalid
Documents_Not_Verified	Cannot perform this action for this customer due to the KYC state

Error Message Code

Description

Required

Named field missing or zero

Invalid

Value given for named field is invalid

Documents_Not_Verified

Cannot perform this action for this customer due to the KYC state

Buy Exchange

This endpoint is intended for initiating a buy exchange, enabling a customer to purchase an asset at a specified price or quantity.

Using the Buy Asset feature, customers can securely order the purchase of digital assets such as Bitcoin using USDC, a stablecoin pegged to the US dollar. This order can be set at a specific price or amount, after which the system processes the order to buy at the most advantageous rates within set parameters, including applicable transaction fees.

Endpoint: /api/v1/customer/crypto-exchanges/buy
Method: POST

Initiate a buy exchange

Request Body:

CustomersId: Customer's Id
AssetPair: Asset pair to trade
QuantityType: Quantity type indicating whether price or amount is fixed (possible values: Price, Amount)
Amount: Amount to request to trade
Price: Price to request to trade for

Response:

Id: Exhcange Id
ExchangeType: Exchange type (possible values: Buy, Sell)
Status: Exchange status (possible values: WaitingForApproval, Rejected, WaitingForConfirmation, AwaitingRfi, Pending, Completed, Failed)
FromTransactionsId: Associated exchange transaction from debited customer asset account
ToTransactionsId: Associated exchange transaction to credited customer asset account
CustomersId: Customer's Id
AssetPair: Asset pair
RequestAmount: Amount requested
RequestPrice: Price requested
ExecutedAmount: Amount executed
ExecutedPrice: Price executed
CommissionFee: Commission fee
PayeesId: null for buy exchanges
TransferType: null for buy exchanges
bHasOpenRfi: false for buy exchanges

Possible validation errors:

Required
Invalid
Price_Too_Low (specified price lower than minimum allowed)
Amount_Too_Low (specified amount lower than minimum allowed)
Price_Too_High (specified price higher than maximum allowed)
Amount_Too_High (specified amount highter than maximum allowed)
Screening_Failed (transfer to an external payee screening failed, exchange not permitted)
Insufficient_Customer_Balance (managee does not have sufficient balance for exchange)
Price_Updated (Asset price has updated, exchange cannot be executed at requested price)

POSThttp://public-api.ibanera.com/api/v1/customer/crypto-exchanges/buy

Header parameters

Body

customersIdinteger (int32)

payeesIdnullable integer (int32)

assetPairnullable string

quantityTypeAvamaeTemplate.Core.Enums.ExchangeQuantityTypes (enum)

amountnullable number (double)

pricenullable number (double)

transferTypeAvamaeTemplate.Core.Enums.TransferTypes (enum)

01234

Response

Success

Body

statusnullable string

errorsnullable array of AvamaeTemplate.Core.Types.Results.Base.ErrorResultDto (object)

idinteger (int64)

detailsAvamaeTemplate.Core.Types.Dtos.CustomerRole.CryptoExchangesModule.AssetExchangeDto (object)

Request

const response = await fetch('http://public-api.ibanera.com/api/v1/customer/crypto-exchanges/buy', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json-patch+json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "status": "text",
  "errors": [
    {
      "fieldName": "text",
      "messageCode": "text"
    }
  ],
  "details": {
    "exchangeType": 0,
    "status": 0,
    "assetPair": "text",
    "requestAmount": 0,
    "requestPrice": 0,
    "executedAmount": 0,
    "executedPrice": 0,
    "commissionFee": 0,
    "transferType": 0,
    "bHasOpenRfi": false
  }
}

Request Body Parameters:

customersId (Integer): The ID of the customer initiating the purchase—required.
assetPair (String): The asset pair to be traded, such as "BTC/USDC"—required.
quantityType (String): Specifies the fixed value type in the quote, either "Price" or "Amount"—required.
amount (Decimal): The amount to be bought, used when the quantityType is "Amount"—required if quantityType is "Amount".
price (Decimal): The price at which to buy, used when the quantityType is "Price"—required if quantityType is "Price".

Request Example:

{
  "customersId": 1004,
  "assetPair": "BTC/USDC",
  "quantityType": "Price",
  "amount": 0.004,
  "price": 100
}

Response Body Parameters:

id (Integer): Not used.
details (Object):
- id (Integer): The unique identifier for this buy exchange transaction.
- exchangeType (String): Set to "Buy".
- status (String): The status of the transaction, such as "Pending".
  - Possible values: WaitingForApproval, Rejected, WaitingForConfirmation, Pending, Completed, Failed
- fromTransactionsId (Integer): The ID of the transaction debiting the payee.
- toTransactionsId (Integer): The ID of the transaction crediting the customer.
- customersId (Integer): The customer's ID.
- assetPair (String): The asset pair for the exchange.
- requestAmount (Decimal): The requested quantity to buy.
- requestPrice (Decimal): The requested price for the buy.
- executedAmount (Decimal): The actual quantity bought if the order is fulfilled.
- executedPrice (Decimal): The price at which the order was executed.
- commissionFee (Decimal): Fee charged for the transaction.
- payeesId (Integer): Null for buy exchanges.
- transferType (String): Null for buy exchanges.
- bHasOpenRfi (Boolean): False for buy exchanges.

Success Response Example:

{
  "id": 0,
  "details": {
    "id": 23304,
    "exchangeType": "Buy",
    "status": "Pending",
    "fromTransactionsId": 3412,
    "toTransactionsId": 3411,
    "customersId": 1004,
    "assetPair": "BTC/USDC",
    "requestAmount": 0.004,
    "requestPrice": 100.0,
    "executedAmount": 0.00399,
    "executedPrice": 100.0,
    "commissionFee": 1.50
  },
  "status": "1",
  "errors": []
}

Possible Error Codes

Error Message Code	Description
Required	Named field missing or zero
Invalid	Value given for named field is invalid
Documents_Not_Verified	Cannot perform this action for this customer due to the KYC state

Error Message Code

Description

Required

Named field missing or zero

Invalid

Value given for named field is invalid

Documents_Not_Verified

Cannot perform this action for this customer due to the KYC state

List Exchanges

Provides a system generated list of crypto asset exchanges, with ability to filter by the type of exchange (Buy / Sell), the Status of the exchange, and CustomersID, asset pair.

Endpoint: /api/v1/customer/crypto-exchanges/buy
Method: GET

List asset exchanges

Request query:

ExchangeType: Exchange type filter (possible values: Buy, Sell) (optional)
Status: Exchange status filter (possible values: WaitingForApproval, Rejected, WaitingForConfirmation, AwaitingRfi, Pending, Completed, Failed) (optional)
CustomersId: Customer's Id filter (optional)
AssetPair: Asset pair filter (optional)
PageNumber: list page number (optional, default = 1)
PageSize: list page size (optional, default = 10)

Response:

array of
- Id: Exhcange Id
- ExchangeType: Exchange type (possible values: Buy, Sell)
- Status: Exchange status (possible values: WaitingForApproval, Rejected, WaitingForConfirmation, AwaitingRfi, Pending, Completed, Failed, AwaitingRfi)
- FromTransactionsId: Associated exchange transaction from debited managee asset account
- ToTransactionsId: Associated exchange transaction to credited managee asset account
- CustomersId: Customer's Id
- AssetPair: Asset pair
- RequestAmount: Amount requested
- RequestPrice: Price requested
- ExecutedAmount: Amount executed
- ExecutedPrice: Price executed
- CommissionFee: Commission fee
- PayeesId: If receiving account is a passthrough account, receiving payee's Id
- TransferType: If receiving account is a passthrough account, type of transfer from passthrough account to payee (possible values: Wire, ACH)
- bHasOpenRfi: Flag indicating if request for information is pending to be submitted (FX only)

GEThttp://public-api.ibanera.com/api/v1/customer/crypto-exchanges/list

Query parameters

Header parameters

Response

Success

Body

statusnullable string

errorsnullable array of AvamaeTemplate.Core.Types.Results.Base.ErrorResultDto (object)

idinteger (int64)

detailsnullable array of AvamaeTemplate.Core.Types.Dtos.CustomerRole.CryptoExchangesModule.AssetExchangeDto (object)

pageSizenullable integer (int32)

pageNumbernullable integer (int32)

numberOfPagesnullable integer (int32)

Request

const response = await fetch('http://public-api.ibanera.com/api/v1/customer/crypto-exchanges/list', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "status": "text",
  "errors": [
    {
      "fieldName": "text",
      "messageCode": "text"
    }
  ],
  "details": [
    {
      "exchangeType": 0,
      "status": 0,
      "assetPair": "text",
      "requestAmount": 0,
      "requestPrice": 0,
      "executedAmount": 0,
      "executedPrice": 0,
      "commissionFee": 0,
      "transferType": 0,
      "bHasOpenRfi": false
    }
  ]
}

Request Query

Optional Request Query Parameters:

customersId (Integer): The ID of the customer initiating the purchase.
assetPair (String): The asset pair to be filtered, such as "BTC/USDC".
exchangeType (String): Specifies the type of exchanges to filter (possible values: Buy, Sell).
status (String): Exchange status filter (possible values: WaitingForApproval, Rejected, WaitingForConfirmation, AwaitingRfi, Pending, Completed, Failed)
PageNumber (Integer): List page number (default = 1)
PageSize (Integer): List page size (default = 10)

Request Query Example

{{endpoint}}/api/v1/customer/crypto-exchanges/list?CustomersId=1001

Response Body Example

{
    "id": 1001,
    "details": [
        {
            "id": 1001,
            "exchangeType": "Sell",
            "status": "WaitingForConfirmation",
            "fromTransactionsId": 12345,
            "toTransactionsId": 12346,
            "customersId": 1001,
            "assetPair": "USDC/USD",
            "requestAmount": 4030.340000000000000000,
            "requestPrice": 4007.800000000000000000,
            "executedAmount": null,
            "executedPrice": null,
            "commissionFee": 20.140000000000000000,
            "payeesId": 1001,
            "transferType": "ACH",
            "bHasOpenRfi": false
        },
        {
            "id": 1002,
            "exchangeType": "Sell",
            "status": "Completed",
            "fromTransactionsId": 12345,
            "toTransactionsId": 12346,
            "customersId": 1001,
            "assetPair": "USDC/USD",
            "requestAmount": 5037.320000000000000000,
            "requestPrice": 5009.640000000000000000,
            "executedAmount": 5037.320301634090314320,
            "executedPrice": 5009.640000000000000000,
            "commissionFee": 25.170000000000000000,
            "payeesId": 1001,
            "transferType": "ACH",
            "bHasOpenRfi": false
        },
        {
            "id": 1003,
            "exchangeType": "Buy",
            "status": "Pending",
            "fromTransactionsId": 12345,
            "toTransactionsId": 12346,
            "customersId": 1001,
            "assetPair": "USDC/USD",
            "requestAmount": 48.430000000000000000,
            "requestPrice": 50.430000000000000000,
            "executedAmount": null,
            "executedPrice": null,
            "commissionFee": 0.000000000000000000,
            "payeesId": null,
            "transferType": null,
            "bHasOpenRfi": false
        },
        {
            "id": 1004,
            "exchangeType": "Sell",
            "status": "WaitingForConfirmation",
            "fromTransactionsId": 12345,
            "toTransactionsId": 12346,
            "customersId": 1001,
            "assetPair": "USDC/USD",
            "requestAmount": 25.500000000000000000,
            "requestPrice": 20.000000000000000000,
            "executedAmount": null,
            "executedPrice": null,
            "commissionFee": 3.500000000000000000,
            "payeesId": 1001,
            "transferType": "ACH",
            "bHasOpenRfi": false
        },
        {
            "id": 1005,
            "exchangeType": "Sell",
            "status": "WaitingForConfirmation",
            "fromTransactionsId": 12345,
            "toTransactionsId": 12346,
            "customersId": 1001,
            "assetPair": "USDC/USD",
            "requestAmount": 25.500000000000000000,
            "requestPrice": 20.000000000000000000,
            "executedAmount": null,
            "executedPrice": null,
            "commissionFee": 3.500000000000000000,
            "payeesId": 1001,
            "transferType": "ACH",
            "bHasOpenRfi": false
        },
        {
            "id": 1006,
            "exchangeType": "Sell",
            "status": "WaitingForConfirmation",
            "fromTransactionsId": 12345,
            "toTransactionsId": 12346,
            "customersId": 1001,
            "assetPair": "USDC/USD",
            "requestAmount": 67.000000000000000000,
            "requestPrice": 39.990000000000000000,
            "executedAmount": null,
            "executedPrice": null,
            "commissionFee": 25.000000000000000000,
            "payeesId": 1001,
            "transferType": "Wire",
            "bHasOpenRfi": false
        },
        {
            "id": 1007,
            "exchangeType": "Sell",
            "status": "WaitingForConfirmation",
            "fromTransactionsId": 12345,
            "toTransactionsId": 12346,
            "customersId": 1001,
            "assetPair": "ETH/USD",
            "requestAmount": 0.021422500000000000,
            "requestPrice": 40.510000000000000000,
            "executedAmount": null,
            "executedPrice": null,
            "commissionFee": 25.000000000000000000,
            "payeesId": 1001,
            "transferType": "Wire",
            "bHasOpenRfi": false
        },
        {
            "id": 1008,
            "exchangeType": "Sell",
            "status": "WaitingForConfirmation",
            "fromTransactionsId": 12345,
            "toTransactionsId": 12346,
            "customersId": 1001,
            "assetPair": "ETH/USD",
            "requestAmount": 0.008122880000000000,
            "requestPrice": 20.030000000000000000,
            "executedAmount": null,
            "executedPrice": null,
            "commissionFee": 3.500000000000000000,
            "payeesId": 1001,
            "transferType": "ACH",
            "bHasOpenRfi": false
        },
        {
            "id": 1009,
            "exchangeType": "Buy",
            "status": "Completed",
            "fromTransactionsId": 12345,
            "toTransactionsId": 12346,
            "customersId": 1001,
            "assetPair": "USDC/USD",
            "requestAmount": 16.748325170000000000,
            "requestPrice": 22.250000000000000000,
            "executedAmount": 16.740000000000000000,
            "executedPrice": 22.250000000000000000,
            "commissionFee": 3.500000000000000000,
            "payeesId": null,
            "transferType": null,
            "bHasOpenRfi": false
        },
        {
            "id": 1010,
            "exchangeType": "Sell",
            "status": "Completed",
            "fromTransactionsId": 12345,
            "toTransactionsId": 12346,
            "customersId": 1001,
            "assetPair": "ETH/USD",
            "requestAmount": 0.013405240000000000,
            "requestPrice": 20.000000000000000000,
            "executedAmount": 0.013371975384448000,
            "executedPrice": 20.000000000000000000,
            "commissionFee": 25.000000000000000000,
            "payeesId": 1001,
            "transferType": "Wire",
            "bHasOpenRfi": false
        }
    ],
    "pageSize": 10,
    "pageNumber": 1,
    "numberOfPages": 2,
    "status": "1",
    "errors": []
}

PreviousCards NextPayees

Last updated 22 days ago