binance_get_fiat_payments
List fiat-based crypto buy and sell payments, showing amounts, fees, prices, and status per transaction.
Instructions
List crypto buy/sell payments made with fiat (bank transfer or bank-issued card).
Calls GET /sapi/v1/fiat/payments, signed, IP weight 1 (cheap — unlike
fiat/orders). A "Credit Card" paymentMethod here is a bank-issued card buying
crypto, and is NOT the Binance Card — Binance Card spend has no API surface at
all (.memory/research/03-card-and-gaps.md §1); the closest proxies are
binance_get_funding_wallet and binance_get_pay_transactions (walletType 4/6).
When to Use:
Seeing crypto bought or sold with fiat: source/obtained amounts, price, fee, payment method (buy only), status.
Reconciling a specific purchase by scanning a narrow begin_time/end_time window.
When NOT to Use:
Bank deposits/withdrawals of fiat itself — use
binance_get_fiat_orders.A long backfill across many pages or months — use
binance_get_fiat_history.
Returns:
A markdown list (or JSON with response_format="json") of payments: order number,
fiat amount/currency, obtained crypto amount/currency, price, fee, payment method
(buy only), status, created/updated time. Status values Binance returns: Processing,
Failed, Successful, Finished, Refunding, Refunded, Refund Failed, Order Partial
credit Stopped.
Pagination:
page (1-indexed) / rows (max 500) map directly to the API; the response also
reports Binance's own total row count across all pages. Markdown display is
capped at 50 rows (with a note naming the next page to request); JSON keeps
the full page.
Examples: params = {"transaction_type": "buy", "rows": 50} params = {"transaction_type": "sell", "begin_time": "2026-01-01", "end_time": "2026-02-01"}
Error Handling:
A 200 body with success: false is raised by the client as BinanceEnvelopeError
and surfaced here as Error: .... A malformed begin_time/end_time returns
Error: <field> must be epoch milliseconds or an ISO-8601 string without calling
the API.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |