fiat

Name: fiat
Author: binance

939stars183forks

How to install fiat?

binance/binance-skills-hub/fiat

$npx -y skills add binance/binance-skills-hub --skill fiat

Installs into the current project.

Summary

Query Binance fiat payment capabilities — supported countries, currencies, payment methods, limits, and crypto prices — via public APIs, plus authenticated order/payment history lookup. Use whenever users ask about buying or selling crypto with fiat, depositing or withdrawing fia

Files · 1

View on GitHub

SKILL.md

1	# Binance Fiat Skill
2
3	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).
4
5	## Base URL
6
7	```
8	https://www.binance.com/bapi/fiat/v1/public/fiatpayment/agent
9	```
10
11	## Available APIs
12
13	### 1. get_capabilities
14
15	Query supported fiat currencies, cryptos, and business types for a country.
16
17	```bash
18	curl "https://www.binance.com/bapi/fiat/v1/public/fiatpayment/agent/get-capabilities?country={COUNTRY_CODE}"
19	```
20
21	Optional: `businessType` (BUY, SELL, DEPOSIT, WITHDRAW) to filter.
22
23	Response: `data.supportedBusinessTypes`, `data.fiatCurrencies[]` (with `code`, `name`, `supportedBusinessTypes`), `data.cryptoCurrencies[]`
24
25	### 2. get_buy_and_sell_payment_methods
26
27	```bash
28	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}"
29	```
30
31	All 4 parameters required.
32
33	Response: `data.paymentMethods[]` and `data.p2pPaymentMethods[]`, each with `code`, `paymentMethodName`, `fiatMinLimit`, `fiatMaxLimit`, `cryptoMinLimit`, `cryptoMaxLimit`, `quotation`, `suspended`
34
35	### 3. get_deposit_and_withdraw_payment_methods
36
37	```bash
38	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}"
39	```
40
41	All 3 parameters required. No `cryptoCurrency`, no `quotation`, no P2P methods.
42
43	Response: `data.paymentMethods[]` with `code`, `paymentMethodName`, `fiatMinLimit`, `fiatMaxLimit`, `suspended`
44
45	### 4. get_price
46
47	```bash
48	curl "https://www.binance.com/bapi/fiat/v1/public/fiatpayment/agent/get-price?fiatCurrency={FIAT}&cryptoCurrency={CRYPTO}&country={COUNTRY_CODE}"
49	```
50
51	Optional: `businessType` (BUY or SELL, defaults to BUY).
52
53	Response: `data.bestPrice` — indicative reference price, may differ from execution price
54
55	## Recommended Workflow
56
57	1. `get_capabilities` first — confirms what's supported before making other calls
58	2. Payment methods API — BUY/SELL → `get_buy_and_sell_payment_methods`; DEPOSIT/WITHDRAW → `get_deposit_and_withdraw_payment_methods`
59	3. `get_price` — add if the user wants exchange rate info
60
61	Skip step 1 for simple price queries (e.g., "What's BTC in USD?").
62
63	## Calling APIs
64
65	Use `WebFetch` or `Bash` (curl). All responses follow:
66
67	```json
68	{ "code": "000000", "message": null, "data": { ... }, "success": true }
69	```
70
71	`code: "000000"` = success; otherwise check `message`.
72
73	## Action Links
74
75	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.
76
77	### URL Templates
78
79	\| Business Type \| URL Template \| Example \|
80	\|---\|---\|---\|
81	\| BUY \| `https://www.binance.com/en/crypto/buy/{FIAT}/{CRYPTO}` \| [Buy BTC with USD](https://www.binance.com/en/crypto/buy/USD/BTC) \|
82	\| SELL \| `https://www.binance.com/en/crypto/sell/{FIAT}/{CRYPTO}` \| [Sell BTC for USD](https://www.binance.com/en/crypto/sell/USD/BTC) \|
83	\| DEPOSIT \| `https://www.binance.com/en/fiat/deposit/{FIAT}` \| [Deposit USD](https://www.binance.com/en/fiat/deposit/USD) \|
84	\| WITHDRAW \| `https://www.binance.com/en/fiat/withdraw/{FIAT}` \| [Withdraw USD](https://www.binance.com/en/fiat/withdraw/USD) \|
85
86	### Language-aware URL
87
88	Replace the `/en/` locale segment to match the user's language. Supported locales:
89
90	```
91	en, zh-CN, zh-TC, ru, es, es-LA, fr, vi, en-TR, it, pl, id, uk-UA, ar,
92	en-AU, pt-BR, en-IN, en-NG, ro, bg, cs, lv, sv, pt, es-MX, el, sk, sl,
93	es-AR, fr-AF, en-KZ, en-ZA, en-NZ, en-BH, ar-BH, ru-UA, de, kk-KZ,
94	ru-KZ, ja, da-DK, en-AE, en-JP, hu, lo-LA, si-LK, az-AZ, uz-UZ, pt-AO
95	```
96
97	Common mapping examples:
98
99	\| User language \| Locale \| Example URL \|
100	\|---\|---\|---\|
101	\| English \| `en` \| `https://www.binance.com/en/crypto/buy/USD/BTC` \|
102	\| 简体中文 \| `zh-CN` \| `https://www.binance.com/zh-CN/crypto/buy/CNY/BTC` \|
103	\| Português (BR) \| `pt-BR` \| `https://www.binance.com/pt-BR/crypto/buy/BRL/BTC` \|
104	\| Türkçe \| `en-TR` \| `https://www.binance.com/en-TR/crypto/buy/TRY/BTC` \|
105
106	For regional English variants (en-AU, en-IN, en-NG, en-AE, en-NZ, etc.), use the specific regional locale rather than plain `en` — this ensures the user sees region-appropriate content

People who liked this also viewed

6 picks

Type

fiat

939stars183forks

View on GitHub

How to install fiat?

binance/binance-skills-hub/fiat

$npx -y skills add binance/binance-skills-hub --skill fiat

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Binance Fiat Skill
2
3	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).
4
5	## Base URL
6
7	```
8	https://www.binance.com/bapi/fiat/v1/public/fiatpayment/agent
9	```
10
11	## Available APIs
12
13	### 1. get_capabilities
14
15	Query supported fiat currencies, cryptos, and business types for a country.
16
17	```bash
18	curl "https://www.binance.com/bapi/fiat/v1/public/fiatpayment/agent/get-capabilities?country={COUNTRY_CODE}"
19	```
20
21	Optional: `businessType` (BUY, SELL, DEPOSIT, WITHDRAW) to filter.
22
23	Response: `data.supportedBusinessTypes`, `data.fiatCurrencies[]` (with `code`, `name`, `supportedBusinessTypes`), `data.cryptoCurrencies[]`
24
25	### 2. get_buy_and_sell_payment_methods
26
27	```bash
28	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}"
29	```
30
31	All 4 parameters required.
32
33	Response: `data.paymentMethods[]` and `data.p2pPaymentMethods[]`, each with `code`, `paymentMethodName`, `fiatMinLimit`, `fiatMaxLimit`, `cryptoMinLimit`, `cryptoMaxLimit`, `quotation`, `suspended`
34
35	### 3. get_deposit_and_withdraw_payment_methods
36
37	```bash
38	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}"
39	```
40
41	All 3 parameters required. No `cryptoCurrency`, no `quotation`, no P2P methods.
42
43	Response: `data.paymentMethods[]` with `code`, `paymentMethodName`, `fiatMinLimit`, `fiatMaxLimit`, `suspended`
44
45	### 4. get_price
46
47	```bash
48	curl "https://www.binance.com/bapi/fiat/v1/public/fiatpayment/agent/get-price?fiatCurrency={FIAT}&cryptoCurrency={CRYPTO}&country={COUNTRY_CODE}"
49	```
50
51	Optional: `businessType` (BUY or SELL, defaults to BUY).
52
53	Response: `data.bestPrice` — indicative reference price, may differ from execution price
54
55	## Recommended Workflow
56
57	1. `get_capabilities` first — confirms what's supported before making other calls
58	2. Payment methods API — BUY/SELL → `get_buy_and_sell_payment_methods`; DEPOSIT/WITHDRAW → `get_deposit_and_withdraw_payment_methods`
59	3. `get_price` — add if the user wants exchange rate info
60
61	Skip step 1 for simple price queries (e.g., "What's BTC in USD?").
62
63	## Calling APIs
64
65	Use `WebFetch` or `Bash` (curl). All responses follow:
66
67	```json
68	{ "code": "000000", "message": null, "data": { ... }, "success": true }
69	```
70
71	`code: "000000"` = success; otherwise check `message`.
72
73	## Action Links
74
75	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.
76
77	### URL Templates
78
79	\| Business Type \| URL Template \| Example \|
80	\|---\|---\|---\|
81	\| BUY \| `https://www.binance.com/en/crypto/buy/{FIAT}/{CRYPTO}` \| [Buy BTC with USD](https://www.binance.com/en/crypto/buy/USD/BTC) \|
82	\| SELL \| `https://www.binance.com/en/crypto/sell/{FIAT}/{CRYPTO}` \| [Sell BTC for USD](https://www.binance.com/en/crypto/sell/USD/BTC) \|
83	\| DEPOSIT \| `https://www.binance.com/en/fiat/deposit/{FIAT}` \| [Deposit USD](https://www.binance.com/en/fiat/deposit/USD) \|
84	\| WITHDRAW \| `https://www.binance.com/en/fiat/withdraw/{FIAT}` \| [Withdraw USD](https://www.binance.com/en/fiat/withdraw/USD) \|
85
86	### Language-aware URL
87
88	Replace the `/en/` locale segment to match the user's language. Supported locales:
89
90	```
91	en, zh-CN, zh-TC, ru, es, es-LA, fr, vi, en-TR, it, pl, id, uk-UA, ar,
92	en-AU, pt-BR, en-IN, en-NG, ro, bg, cs, lv, sv, pt, es-MX, el, sk, sl,
93	es-AR, fr-AF, en-KZ, en-ZA, en-NZ, en-BH, ar-BH, ru-UA, de, kk-KZ,
94	ru-KZ, ja, da-DK, en-AE, en-JP, hu, lo-LA, si-LK, az-AZ, uz-UZ, pt-AO
95	```
96
97	Common mapping examples:
98
99	\| User language \| Locale \| Example URL \|
100	\|---\|---\|---\|
101	\| English \| `en` \| `https://www.binance.com/en/crypto/buy/USD/BTC` \|
102	\| 简体中文 \| `zh-CN` \| `https://www.binance.com/zh-CN/crypto/buy/CNY/BTC` \|
103	\| Português (BR) \| `pt-BR` \| `https://www.binance.com/pt-BR/crypto/buy/BRL/BTC` \|
104	\| Türkçe \| `en-TR` \| `https://www.binance.com/en-TR/crypto/buy/TRY/BTC` \|
105
106	For regional English variants (en-AU, en-IN, en-NG, en-AE, en-NZ, etc.), use the specific regional locale rather than plain `en` — this ensures the user sees region-appropriate content

People who liked this also viewed

6 picks

Type