Prepaid Fee - Finrock

MCP scope: dac.read Finrock operates as a non-custodial wallet provider, which means it never holds or accesses the funds in your custody wallets. Because of this model, platform fees — such as fees for processing deposits — are not deducted from your wallet balances. Instead, Finrock uses a dedicated prepaid fee account that you fund in advance. This endpoint lets you retrieve and manage your prepaid fee configuration programmatically, ensuring your account remains funded and platform services remain uninterrupted.

How the Prepaid Fee System Works

Your prepaid fee account is separate from all custody wallet balances. Finrock automatically deducts applicable platform fees from this account based on your subscription tier as you use the platform. If the prepaid fee balance reaches zero or negative, certain actions — particularly withdrawals — may be suspended until you top it up.

Your wallet assets are always safe regardless of your prepaid fee balance. A zero prepaid balance only affects platform service availability, not the security or custody of your funds.

Body Parameters

Method: GET
URL: https://api.finrock.io/dac/v1/prepaid-fee

Headers

string

default:"application/json"

Must be application/json.

curl --request GET \
     --url https://api.finrock.io/dac/v1/prepaid-fee \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: {{api_key}}' \
     --header 'Authorization: Token {JWT}' \
     --data '{}'

{
  "balance": 100.00,
  "mode": "Prepaid",
  "bps": 25
}

Response

A successful request returns your current prepaid fee account details: the available balance, the fee mode, and the fee rate applied to your account.

number

Current balance of your prepaid fee account. Platform fees are deducted from this balance as you use Finrock. When it reaches zero or below, some actions, such as withdrawals, may be suspended until you top it up.

string

How platform fees are billed to your account. Prepaid means fees are deducted from your prepaid fee account balance rather than from your custody wallets.

integer

Platform fee rate for your subscription tier, in basis points (1 bps = 0.01%). For example, 25 means a fee of 0.25% of the transaction amount.

Best Practices

Monitor Regularly

Check your prepaid balance as part of your regular operational monitoring to avoid unexpected service interruptions.

Top Up Proactively

Fund your prepaid account before it runs low rather than waiting for interruptions. Set an alert threshold based on your average daily transaction volume.