---
title: "Estimate fees for a transaction before executing it."
method: POST
path: "/v0.2.4/info/fee-estimate"
tags: ["Info"]
---

# Estimate fees for a transaction before executing it.

`POST /v0.2.4/info/fee-estimate`

Returns estimated fees for a given amount and optional rail. When rail is omitted, assumes a standard chimoney payout and currency must be USD.

## Request body

- object
  - `amount` number, required — The transaction amount.
  - `currency` string — Three-letter currency code (defaults to USD). Must be USD when rail is not specified.
  - `rail` 'bank' | 'airtime' | 'mobile-money' | 'interac' | 'spei' | 'wallet' | 'gift-card' | 'chimoney' | 'interledger' — The payment rail. Optional — when omitted, assumes a standard chimoney payout.
  - `direction` 'payout' | 'funding' — Transaction direction (defaults to payout).

## Response `200`

Fee estimate retrieved successfully.

- object
  - `status` string
  - `message` string
  - `data` object
    - `amount` number
    - `currency` string
    - `rail` string
    - `direction` string
    - `platformFee` number — Chimoney platform fee.
    - `railFee` number — Rail-specific fee (e.g. Interac transfer fee).
    - `totalFee` number — Sum of platformFee and railFee.
    - `netAmount` number — Amount after deducting totalFee.
    - `breakdown` object
      - `platformFee` object
        - `amount` number
        - `description` string
      - `railFee` object
        - `amount` number
        - `description` string
    - `note` string — Disclaimer that fees are estimates.

## Other responses

- `400` — Validation error in the request.
- `401` — Access to this resource is not available for unauthenticated users.
- `403` — Access to this resource is forbidden.
- `500` — Indicates an internal server error.

---

[API](https://skmtc.net/chimoney/apis/chimoney-api-docs.md) · [All operations](https://skmtc.net/chimoney/apis/chimoney-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chimoney/chimoney-api-docs/revisions/227751df36a0/schema)