Finrax API
HomeChangelogIntegration GuideResources
HomeChangelogIntegration GuideResources
  1. Payments and Withdrawals
  • Getting Started
    • Introduction
    • Environments
    • Errors
    • Authorization
      • API Key Management
      • Signature
      • Code Snippets
  • Payments and Withdrawals
    • Crypto Payments
      • Fetch payment by ID
      • 🔒Fetch payments
      • Submit crypto payment
      • Request crypto payment
    • Fetch withdrawals
      GET
    • Fetch withdrawal metadata
      GET
    • Request crypto withdrawal
      POST
    • Fetch whitelisted addresses
      GET
    • Whitelist an address
      POST
    • Fetch crypto withdrawal approval by ID
      GET
    • Fetch business by ID
      GET
    • Fetch business balance
      GET
    • Unwhitelist an address
      DELETE
  • Callbacks
    • Deposit received notification
    • Withdrawal broadcast notification
    • Withdrawal approved/rejected notification
  • Address validation
    • Validate address
      GET
    • Validate address and destination tag
      GET
  • Rates and metadata
    • Fetch market rates
      GET
    • Fetch fiat rates
      GET
    • Fetch deposit rates
      GET
    • Fetch all currencies
      GET
  1. Payments and Withdrawals

Fetch business balance

GET
/api/v1/balances/{businessId}
Allows you to fetch the current business balance and allocation ratio of a given business.

Request

Authorization
Add parameter in header
FRX-API
Example:
FRX-API: ********************
Path Params
businessId
string <uuid>
required
The business ID to search by.

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://payments.finrax.com/api/v1/balances/' \
--header 'FRX-API;'

Responses

🟢200Returns the specified business's balance.
application/json
Body
businessId
string <uuid>
required
businessName
string 
required
fiatAllocation
string 
required
Ratio of fiat to all settlements allocation for crypto deposits.
settlementFiatCurrency
enum<string> 
required
Allowed values:
EURGBPUSD
settlementFiatAmount
string 
required
settlementFiatCurrency balance.
displayFiatAmount
string 
required
settlementFiatCurrency balance converted to EUR.
cryptoAllocation
string 
required
Ratio of crypto to all settlements allocation for crypto deposits.
settlementCryptoCurrency
enum<string> 
required
Allowed values:
BTCUSDCUSDT
settlementCryptoAmount
string 
required
settlementCryptoCurrency balance.
displayCryptoAmount
string 
required
settlementCryptoCurrency balance converted to EUR.
Example
{
    "businessId": "231cd908-65de-4f88-983e-83ba17102a6c",
    "businessName": "businessName",
    "fiatAllocation": "0.7",
    "settlementFiatCurrency": "EUR",
    "settlementFiatAmount": "10000.55",
    "displayFiatAmount": "12000",
    "cryptoAllocation": "0.3",
    "settlementCryptoCurrency": "USDT",
    "settlementCryptoAmount": "50000.123456",
    "displayCryptoAmount": "55000"
}
Modified at 2024-07-24 14:04:47
Previous
Fetch business by ID
Next
Unwhitelist an address
Built with