> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tender.cash/llms.txt
> Use this file to discover all available pages before exploring further.

# Calculate Payout Fee

> Get the fee for a crypto payout of a given coin and amount on a chain

> [!NOTE]
>
> **Auth method: Signed (HMAC)** — this endpoint requires the full set of signed
> headers: `x-access-id`, `x-request-id`, `x-timestamp`, and an HMAC-SHA256
> `authorization` signature. See [Authentication](https://docs.tender.cash/api-reference/authentication.md#signed-hmac-authentication).

All payout endpoints share a bucket of 10 requests per minute per merchant, on top of the general
limit. See [Rate limits](https://docs.tender.cash/api-reference/rate-limits.md).

The fee is taken out of the amount you send. For a payout of `amount`, your balance is debited
`amount` and the recipient receives `amountDeductedFee` (`amount` − `fee`).

## Headers

**authorization** `string` *required*

Base64-encoded HMAC-SHA256 signature of `{"timeStamp":"<x-timestamp>","requestId":"<x-request-id>","accessId":"<x-access-id>"}`, signed with your access secret. The request body is not part of the signature.

**Example:** `"pV3n0o8kq0lK2mJ8bZ1yq3Yt6hR0cXK9u4mVJ2l9sE0="`

**x-timestamp** `string` *required*

ISO 8601 timestamp; must be within 5 minutes of server time

**Example:** `"2026-10-15T09:45:53.000Z"`

**x-request-id** `string` *required*

A unique UUID v4 per request

**Example:** `"550e8400-e29b-41d4-a716-446655440000"`

**x-access-id** `string` *required*

Your API access ID provided by Tender

**Example:** `"your-access-id-here"`

## Path parameters

**chain** `string` *required*

Chain ID

**Example:** `"tron"`

**coin** `string` *required*

Coin ID

**Example:** `"usdt"`

**amount** `string` *required*

Amount to pay out, in the coin. Must be greater than zero.

**Example:** `"50"`

## Response

**status** `string` *required*

`success` on success

**Example:** `"success"`

**message** `string` *required*

Human-readable result message

**Example:** `"success"`

**data** `object` *required*

Payout fee breakdown

**data properties**

**amount** `number`

The amount you asked to pay out

**Example:** `50`

**amountUSD** `number`

USD value of `amount`

**Example:** `50`

**fee** `number`

Total fee in the coin, including any activation fee

**Example:** `0.5`

**feeUSD** `number`

Total fee in USD

**Example:** `0.5`

**feePercent** `number`

Percentage fee applied to `amount`

**Example:** `1`

**baseFeeUSD** `number`

Cap on the percentage fee, in USD. The activation fee is added on top.

**Example:** `100`

**amountDeductedFee** `number`

What the recipient receives: `amount` − `fee`

**Example:** `49.5`

**amountDeductedFeeUSD** `number`

USD value of `amountDeductedFee`

**Example:** `49.5`

**amountAfterFee** `number`

`amount` + `fee` (gross). This is not the amount delivered; use `amountDeductedFee` for that.

**Example:** `50.5`

**amountAfterFeeUSD** `number`

USD value of `amountAfterFee`

**Example:** `50.5`

**activationFee** `number`

Part of `fee` charged to activate the destination on chains that need it, in the coin.
`0` when none applies.

**Example:** `0`

**activationFeeUSD** `number`

Activation fee in USD

**Example:** `0`

**activationScope** `string`

Which fee setting the activation fee came from: `merchant-coin`, `merchant-chain`,
`global-coin`, `global-chain`, or `none` when no activation fee applies

**Example:** `"none"`

**inclusive** `boolean`

Whether your account is set up for fee-inclusive pricing

**Example:** `false`

**currency** `string`

Coin ID

**Example:** `"usdt"`

**chain** `string`

Chain ID

**Example:** `"tron"`

**estimatedArrival** `string`

Typical arrival time on this chain, or `"Not available"`

**Example:** `"1-3 minutes"`

## Errors

All return HTTP 400.

| Message | Cause |
| - | - |
| `Invalid chain` | Unknown chain |
| `Invalid currency` | Unknown coin |
| `Exchange price not available` | No price for the coin |
| `Amount must be greater than zero` | `amount` is zero or negative |

```bash cURL theme={null}
curl "https://sandbox-api.tender.cash/v1/api/payout/fee/tron/usdt/50" \
  -H "x-access-id: your-access-id-here" \
  -H "x-request-id: 550e8400-e29b-41d4-a716-446655440000" \
  -H "x-timestamp: 2026-10-15T09:45:53.000Z" \
  -H "authorization: <signature>"
```

```json 200 theme={null}
{
  "status": "success",
  "message": "success",
  "data": {
    "amount": 50,
    "amountUSD": 50,
    "fee": 0.5,
    "feeUSD": 0.5,
    "feePercent": 1,
    "baseFeeUSD": 100,
    "amountAfterFee": 50.5,
    "amountAfterFeeUSD": 50.5,
    "activationFee": 0,
    "activationFeeUSD": 0,
    "amountDeductedFee": 49.5,
    "amountDeductedFeeUSD": 49.5,
    "activationScope": "none",
    "inclusive": false,
    "currency": "usdt",
    "chain": "tron",
    "estimatedArrival": "1-3 minutes"
  }
}
```


## OpenAPI

````yaml GET /v1/api/payout/fee/{chain}/{coin}/{amount}
openapi: 3.1.0
info:
  title: Tender API
  description: Tender Developer API for cryptocurrency payments and agent management
  version: 2.0.0
  contact:
    name: Tender Support
    url: https://tender.cash
servers:
  - url: https://secureapi.tender.cash
    description: Production Server
  - url: https://sandbox-api.tender.cash
    description: Sandbox Server
security:
  - SignedAuth: []
tags:
  - name: Agents
    description: Manage agents and sub-businesses
  - name: Transactions
    description: Payment and transaction operations
  - name: System
    description: System information and configuration
  - name: Webhooks
    description: Webhook management and logs
  - name: On-ramp
    description: Fiat-to-crypto on-ramp operations
  - name: Payouts
    description: Send crypto from merchant balance to a wallet address or payout account
  - name: Subwallets
    description: Provision and manage crypto wallet infrastructure for your end-users
  - name: Conversions
    description: Swap crypto between coins and chains, or convert to a payout account
paths:
  /v1/api/payout/fee/{chain}/{coin}/{amount}:
    get:
      tags:
        - Payouts
      summary: Calculate Payout Fee
      description: >-
        Fee for a crypto payout. Your balance is debited `amount`; the recipient
        receives `amountDeductedFee`. `amountAfterFee` is amount + fee (gross).
        Payout endpoints share a 10 requests/minute bucket per merchant.
      operationId: calculatePayoutFee
      parameters:
        - name: authorization
          in: header
          required: true
          description: >-
            Base64-encoded HMAC-SHA256 signature of
            `{"timeStamp":"<x-timestamp>","requestId":"<x-request-id>","accessId":"<x-access-id>"}`,
            signed with your access secret. The request body is not part of the
            signature.
          schema:
            type: string
          example: pV3n0o8kq0lK2mJ8bZ1yq3Yt6hR0cXK9u4mVJ2l9sE0=
        - name: x-timestamp
          in: header
          required: true
          description: ISO 8601 timestamp; must be within 5 minutes of server time
          schema:
            type: string
            format: date-time
          example: '2026-10-15T09:45:53.000Z'
        - name: x-request-id
          in: header
          required: true
          description: A unique UUID v4 per request
          schema:
            type: string
            format: uuid
          example: 550e8400-e29b-41d4-a716-446655440000
        - name: x-access-id
          in: header
          required: true
          schema:
            type: string
          example: your-access-id-here
        - name: chain
          in: path
          required: true
          description: Chain ID
          schema:
            type: string
          example: tron
        - name: coin
          in: path
          required: true
          description: Coin ID
          schema:
            type: string
          example: usdt
        - name: amount
          in: path
          required: true
          description: Amount; must be greater than zero
          schema:
            type: string
          example: '50'
      responses:
        '200':
          description: Fee breakdown
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PayoutFeeResponse'
              example:
                status: success
                message: success
                data:
                  amount: 50
                  amountUSD: 50
                  fee: 0.5
                  feeUSD: 0.5
                  feePercent: 1
                  baseFeeUSD: 100
                  amountAfterFee: 50.5
                  amountAfterFeeUSD: 50.5
                  activationFee: 0
                  activationFeeUSD: 0
                  amountDeductedFee: 49.5
                  amountDeductedFeeUSD: 49.5
                  activationScope: none
                  inclusive: false
                  currency: usdt
                  chain: tron
                  estimatedArrival: 1-3 minutes
        '400':
          description: Unknown chain or coin, no price, or invalid amount
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversionPayoutErrorResponse'
              example:
                status: error
                message: Invalid chain
                data: {}
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversionPayoutErrorResponse'
              example:
                status: error
                message: Too many requests. Max 10 per 60s.
                data: {}
      security:
        - SignedAuth: []
components:
  schemas:
    PayoutFeeResponse:
      type: object
      required:
        - status
        - message
        - data
      properties:
        status:
          type: string
          example: success
        message:
          type: string
          example: success
        data:
          type: object
          properties:
            amount:
              type: number
            amountUSD:
              type: number
            fee:
              type: number
            feeUSD:
              type: number
            feePercent:
              type: number
            baseFeeUSD:
              type: number
              description: Cap on the percentage fee in USD
            amountAfterFee:
              type: number
              description: amount + fee (gross); not the amount delivered
            amountAfterFeeUSD:
              type: number
            activationFee:
              type: number
            activationFeeUSD:
              type: number
            amountDeductedFee:
              type: number
              description: 'What the recipient receives: amount - fee'
            amountDeductedFeeUSD:
              type: number
            activationScope:
              type: string
              enum:
                - merchant-coin
                - merchant-chain
                - global-coin
                - global-chain
                - none
            inclusive:
              type: boolean
            currency:
              type: string
            chain:
              type: string
            estimatedArrival:
              type: string
              description: '"Not available" when unknown'
    ConversionPayoutErrorResponse:
      type: object
      properties:
        status:
          type: string
          example: error
        message:
          type: string
        data:
          type: object
          nullable: true
  securitySchemes:
    SignedAuth:
      type: apiKey
      in: header
      name: authorization
      description: >-
        Signed (HMAC) authentication. Required headers: x-access-id,
        x-request-id (UUID v4), x-timestamp (ISO 8601, must be within 5 minutes
        of server time), and authorization: the Base64 HMAC-SHA256 of the JSON
        string
        {"timeStamp":"<x-timestamp>","requestId":"<x-request-id>","accessId":"<x-access-id>"}
        (keys in that order, no whitespace) using your access secret. The
        request body, method and path are not signed. The API key must be linked
        to an outlet.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.