Skip to main content
POST
/
payments
/
estimate_fee
import cobo_waas2
from cobo_waas2.models.payment_estimate_fee201_response import (
    PaymentEstimateFee201Response,
)
from cobo_waas2.models.payment_estimate_fee_request import PaymentEstimateFeeRequest
from cobo_waas2.rest import ApiException
from pprint import pprint

# See configuration.py for a list of all supported configurations.
configuration = cobo_waas2.Configuration(
    # Replace `<YOUR_PRIVATE_KEY>` with your private key
    api_private_key="<YOUR_PRIVATE_KEY>",
    # Select the development environment. To use the production environment, change the URL to https://api.cobo.com/v2.
    host="https://api.dev.cobo.com/v2",
)
# Enter a context with an instance of the API client
with cobo_waas2.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = cobo_waas2.PaymentApi(api_client)
    payment_estimate_fee_request = cobo_waas2.PaymentEstimateFeeRequest(
        estimate_fees=[
            cobo_waas2.PaymentEstimateFee(
                token_id="req_20251230150638", amount="500.00"
            )
        ]
    )

    try:
        # Estimate fees
        api_response = api_instance.payment_estimate_fee(
            payment_estimate_fee_request=payment_estimate_fee_request
        )
        print("The response of PaymentApi->payment_estimate_fee:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling PaymentApi->payment_estimate_fee: %s\n" % e)


{
  "data": [
    {
      "token_id": "<string>",
      "amount": "500.00",
      "commission_fee": {
        "fee_amount": "<string>"
      },
      "bridging_fee": {
        "fee_amount": "<string>",
        "received_token_id": "<string>",
        "received_amount": "<string>",
        "bridge_status": "Completed"
      },
      "otc_fee": {
        "fee_rate": "<string>",
        "token_id": "<string>"
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://cobo.com/payments/llms.txt

Use this file to discover all available pages before exploring further.

import cobo_waas2
from cobo_waas2.models.payment_estimate_fee201_response import (
    PaymentEstimateFee201Response,
)
from cobo_waas2.models.payment_estimate_fee_request import PaymentEstimateFeeRequest
from cobo_waas2.rest import ApiException
from pprint import pprint

# See configuration.py for a list of all supported configurations.
configuration = cobo_waas2.Configuration(
    # Replace `<YOUR_PRIVATE_KEY>` with your private key
    api_private_key="<YOUR_PRIVATE_KEY>",
    # Select the development environment. To use the production environment, change the URL to https://api.cobo.com/v2.
    host="https://api.dev.cobo.com/v2",
)
# Enter a context with an instance of the API client
with cobo_waas2.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = cobo_waas2.PaymentApi(api_client)
    payment_estimate_fee_request = cobo_waas2.PaymentEstimateFeeRequest(
        estimate_fees=[
            cobo_waas2.PaymentEstimateFee(
                token_id="req_20251230150638", amount="500.00"
            )
        ]
    )

    try:
        # Estimate fees
        api_response = api_instance.payment_estimate_fee(
            payment_estimate_fee_request=payment_estimate_fee_request
        )
        print("The response of PaymentApi->payment_estimate_fee:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling PaymentApi->payment_estimate_fee: %s\n" % e)

Authorizations

​
BIZ-API-KEY
string
header
required

The API key. For more details, refer to API key.

In the API playground, enter your API secret, and your API key will be accordingly calculated.

Body

application/json

The request body for fee estimation.

​
estimate_fees
object[]
required

A list of token IDs and amounts for which fees will be calculated.

​
fee_type
enum<string>

The fee type. Possible values include:

  • Order: Fees for order processing.
  • Refund: Fees for refund processing.
  • CryptoSettlement: This fee type is deprecated. Please use CryptoPayout instead.
  • OffRampSettlement: This fee type is deprecated. Please use OffRampPayout instead.
  • CryptoPayout: Fees for crypto payouts.
  • CryptoPayoutBridge: Fees for crypto payouts with cross-chain bridging.
  • OffRampPayout: Fees for fiat off-ramp payouts.
Available options:
Order,
Refund,
CryptoSettlement,
OffRampSettlement,
CryptoPayout,
CryptoPayoutBridge,
OffRampPayout
Example:

"Order"

​
recipient_token_id
string

The token ID that the recipient will receive. Required only when fee_type is CryptoPayoutBridge.

​
transfer_via_va
boolean

For OffRamp payout, whether the payout is transferred to a registered bank account via a virtual account (VA) or directly.

  • true: The payout is transferred to a registered bank account via a VA (virtual account).
  • false: The payout is transferred directly to a registered bank account.
Example:

false

Response

The request was successful.

​
data
object[]

A list of estimated fees for the requested operations.