Fiat
Answer fiat on-ramp/off-ramp questions and query Binance public fiat capability APIs (and authenticated order history when configured) from your agent.
Overview
fiat is an agent skill for the Build phase that queries Binance fiat payment public APIs (and guided authenticated history) for countries, methods, rates, and orders.
Install
npx skills add https://github.com/binance/binance-skills-hub --skill fiatWhat is this skill?
- Public `get-capabilities` by country with optional businessType filter (BUY, SELL, DEPOSIT, WITHDRAW)
- Payment methods and buy/sell rails via documented fiat payment agent URLs
- Surfaces supported fiat currencies, cryptos, and business types without auth for capability discovery
- Authenticated order and payment history patterns referenced in bundled SAPI endpoint docs (v1.1.0)
- Triggers on questions about buying/selling crypto with fiat, country payment options, or fiat order history even if the
- Skill metadata version 1.1.0 (author Binance).
- Public base path under `/bapi/fiat/v1/public/fiatpayment/agent` with documented get_capabilities and buy/sell payment me
Adoption & trust: 2.8k installs on skills.sh; 881 GitHub stars; 0/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need accurate, country-specific fiat-crypto payment options and order context without manually digging through Binance API references.
Who is it for?
Solo builders adding fiat on-ramps, pricing displays, or support assistants grounded in Binance’s live capability matrix.
Skip if: Non-custodial wallet apps with no Binance relationship, or legal/compliance sign-off without human review of local regulations.
When should I use this skill?
Whenever users ask about buying or selling crypto with fiat, fiat deposit/withdraw, fiat-crypto rates, payment options in a specific country, or fiat order history—even if they do not mention Binance APIs.
What do I get? / Deliverables
Your agent returns structured capability, method, and pricing data from Binance fiat endpoints—or follows the skill’s authenticated references for order/payment history when keys are available.
- Structured answers listing supported business types, fiat/crypto currencies, and payment methods for a country
- curl-ready request patterns and pointers to authenticated SAPI flows when needed
Recommended Skills
Journey fit
Fiat rails are product integrations you implement while wiring payments and exchange features into an app or agent workflow. The skill documents REST calls against Binance `bapi/fiat` public agent endpoints plus optional signed SAPI history references.
How it compares
Fiat capability lookups via Binance’s agent HTTP API—not generic web search guesses about which payment methods exist in a country.
Common Questions / FAQ
Who is fiat for?
Indie developers and agent authors building crypto-finance features who need Binance-aligned answers on fiat currencies, payment methods, and order history patterns.
When should I use fiat?
During Build integrations while designing checkout, treasury, or support flows that must list supported BUY/SELL/DEPOSIT/WITHDRAW options for a country or pull fiat order history with proper auth.
Is fiat safe to install?
Public endpoints need no keys, but authenticated sections involve account data—review the Security Audits panel on this Prism page and never paste API secrets into prompts.
SKILL.md
READMESKILL.md - Fiat
# Binance Fiat Skill Query Binance fiat payment capabilities, available payment methods, pricing, and supported currencies/countries using **public APIs** (no authentication required). For order and payment history, see [Authenticated Endpoints](./references/sapi-endpoints.md). ## Base URL ``` https://www.binance.com/bapi/fiat/v1/public/fiatpayment/agent ``` ## Available APIs ### 1. get_capabilities Query supported fiat currencies, cryptos, and business types for a country. ```bash curl "https://www.binance.com/bapi/fiat/v1/public/fiatpayment/agent/get-capabilities?country={COUNTRY_CODE}" ``` Optional: `businessType` (BUY, SELL, DEPOSIT, WITHDRAW) to filter. **Response:** `data.supportedBusinessTypes`, `data.fiatCurrencies[]` (with `code`, `name`, `supportedBusinessTypes`), `data.cryptoCurrencies[]` ### 2. get_buy_and_sell_payment_methods ```bash curl "https://www.binance.com/bapi/fiat/v1/public/fiatpayment/agent/get-buy-and-sell-payment-methods?businessType={BUY|SELL}&fiatCurrency={FIAT}&cryptoCurrency={CRYPTO}&country={COUNTRY_CODE}" ``` All 4 parameters required. **Response:** `data.paymentMethods[]` and `data.p2pPaymentMethods[]`, each with `code`, `paymentMethodName`, `fiatMinLimit`, `fiatMaxLimit`, `cryptoMinLimit`, `cryptoMaxLimit`, `quotation`, `suspended` ### 3. get_deposit_and_withdraw_payment_methods ```bash curl "https://www.binance.com/bapi/fiat/v1/public/fiatpayment/agent/get-deposit-and-withdraw-payment-methods?businessType={DEPOSIT|WITHDRAW}&fiatCurrency={FIAT}&country={COUNTRY_CODE}" ``` All 3 parameters required. No `cryptoCurrency`, no `quotation`, no P2P methods. **Response:** `data.paymentMethods[]` with `code`, `paymentMethodName`, `fiatMinLimit`, `fiatMaxLimit`, `suspended` ### 4. get_price ```bash curl "https://www.binance.com/bapi/fiat/v1/public/fiatpayment/agent/get-price?fiatCurrency={FIAT}&cryptoCurrency={CRYPTO}&country={COUNTRY_CODE}" ``` Optional: `businessType` (BUY or SELL, defaults to BUY). **Response:** `data.bestPrice` — indicative reference price, may differ from execution price ## Recommended Workflow 1. **`get_capabilities`** first — confirms what's supported before making other calls 2. **Payment methods API** — BUY/SELL → `get_buy_and_sell_payment_methods`; DEPOSIT/WITHDRAW → `get_deposit_and_withdraw_payment_methods` 3. **`get_price`** — add if the user wants exchange rate info Skip step 1 for simple price queries (e.g., "What's BTC in USD?"). ## Calling APIs Use `WebFetch` or `Bash` (curl). All responses follow: ```json { "code": "000000", "message": null, "data": { ... }, "success": true } ``` `code: "000000"` = success; otherwise check `message`. ## Action Links After presenting API results, always include a relevant action link so the user can proceed directly on Binance. Build the URL dynamically based on the fiat currency, crypto currency, and business type from the conversation context. ### URL Templates | Business Type | URL Template | Example | |---|---|---| | BUY | `https://www.binance.com/en/crypto/buy/{FIAT}/{CRYPTO}` | [Buy BTC with USD](https://www.binance.com/en/crypto/buy/USD/BTC) | | SELL | `https://www.binance.com/en/crypto/sell/{FIAT}/{CRYPTO}` | [Sell BTC for USD](https://www.binance.com/en/crypto/sell/USD/BTC) | | DEPOSIT | `https://www.binance.com/en/fiat/deposit/{FIAT}` | [Deposit USD](https://www.binance.com/en/fiat/deposit/USD) | | WITHDRAW | `https://www.binance.com/en/fiat/withdraw/{FIAT}` | [Withdraw USD](https://