Estimate

Common Parameters

These parameters are used to simulate a payout and calculate fees, routing, and liquidity availability. No blockchain transactions are created.

Payout Estimate

POST https://api-processing.crypto-chief.com/v1/payout/estimate

Headers

Name	Value
Content-Type	application/json
Signature	Signed request body
Merchant	Merchant ID

Body

Name	Type	Required	Description
amount	string	true	Requested payout amount in human-readable units)
network	CHAIN	true	Target blockchain network
coin	COIN	true	Asset to be sent
to_address	string	true	Recipient address
memo	string	false	Optional memo / destination tag (for supported networks)
from_addresses	string[]	false	Whitelist of Master Wallet addresses allowed as payout sources
allow_multiple_sources	bool	false	Allow splitting payout across multiple Master Wallets. Default: false
auto_convert	bool	false	Enable automatic conversion from other assets (not implemented)
auto_convert_policy	ASSETS_POLICY	false	Conversion rules configuration (reserved for future use)
max_fee_amount_fiat	string	false	Maximum allowed total fee in USD (gas + refuel)

Response

Root Fields

Field	Type	Description
amount_requested	string	Original requested payout amount (human units)
amount_to_receive	string	Final amount to be received after fee handling
fee_info	object	Aggregated fee information
sources	array	Planned payout source transactions
service_operations	array	Planned service operations (refuel / convert)
coins	array	Available balances per Master Wallet

200

{
  "amount_requested": "100.00",
  "amount_to_receive": "100.00",

  "fee_info": {
    "fee_mode": "service",
    "estimated_fiat": "1.27",
    "limit_fiat": "2.00",
    "limit_currency": "USD"
  },

  "sources": [
    {
      "address": "0xA1b2c3d4e5f6",
      "network": "ETH_MAINNET",
      "coin": "USDT",
      "amount_crypto": "60.00",

      "need_refuel": false,
      "refuel_amount": "0",
      "estimated_fee": "0.00045",
      "estimated_fee_fiat": "0.58"
    },
    {
      "address": "0xF9e8d7c6b5a4",
      "network": "ETH_MAINNET",
      "coin": "USDT",
      "amount_crypto": "40.00",

      "need_refuel": true,
      "refuel_amount": "0.003",
      "estimated_fee": "0.00038",
      "estimated_fee_fiat": "0.49"
    }
  ],

  "service_operations": [
    {
      "type": "gas_refuel",
      "context": "payout_prepare",
      "status": "planned",
    
      "network": "ETH_MAINNET",
      "coin": "ETH",
      "amount_native": "0.003",
    
      "from_address": "0xSERVICE_WALLET",
      "to_address": "0xF9e8d7c6b5a4",
    
      "estimated_fee": "0.00021",
      "estimated_fee_fiat": "0.20",
    }
  ],

  "coins": [
    {
      "network": "ETH_MAINNET",
      "coin": "USDT",
      "address": "0xA1b2c3d4e5f6",
      "amount_available": "125.42",
      "native_available": "0.12",
      "native_coin": "ETH"
    },
    {
      "network": "ETH_MAINNET",
      "coin": "USDT",
      "address": "0xF9e8d7c6b5a4",
      "amount_available": "52.31",
      "native_available": "0.001",
      "native_coin": "ETH"
    }
  ]
}

400

Asset Object

Name	Type	Required	Description
coin	​COIN​	true	The cryptocurrency ticker symbol (e.g., "USDT", "BTC", "ETH").
network	​CHAIN​	true	The blockchain network code (e.g., , ETH_MAINNET , TRON_MAINNET). Use "ANY" to indicate all available networks for this coin.

JSON example

{
  "coin": "USDT",
  "network": "TRON_MAINNET"
}

ASSETS_POLICY Object

Used in the assets parameter to filter the payment methods shown to the user.

Name	Type	Required	Description
allow	​ASSET []	false	Whitelist. An array of Asset objects. If provided, the user will see only these assets. All others are hidden.
exclude	​ASSET []	false	Blacklist. An array of Asset objects. These specific assets will be hidden from the user.

JSON example

{
  "allow": [
    { "coin": "USDT", "network": "ANY" }
  ],
  "exclude": [
    { "coin": "BTC", "network": "ANY" }
  ]
}