p2p
starsforks
How to install p2p?
binance/binance-skills-hub/p2p
$npx -y skills add binance/binance-skills-hub --skill p2pBinance P2P trading assistant for natural-language queries about P2P/C2C market ads, the user's own P2P order history, order detail & appeal tracking, and advertisement publish & management. Use when the user asks about P2P prices, searching/choosing ads, comparing payment method
SKILL.md
| 1 | # Binance P2P Trading Skill |
| 2 | |
| 3 | Help users interact with **Binance P2P (C2C)** via natural-language queries. |
| 4 | |
| 5 | ## When to Use / When NOT to Use |
| 6 | |
| 7 | ### Use this skill when the user wants to: |
| 8 | - Check **P2P** buy/sell quotes for a crypto/fiat pair (e.g., USDT/CNY). |
| 9 | - Search **P2P advertisements** and filter by payment method(s), limits, merchant quality. |
| 10 | - Compare prices across payment methods (e.g., Alipay vs bank transfer). |
| 11 | - View **their own P2P order history / summary** (requires API key). |
| 12 | - Query **order detail** and view full order timeline (requires API key). |
| 13 | - Check **appeal/complaint status** and view complaint history (requires API key). |
| 14 | - **Submit evidence** for an existing appeal (upload files + submit description) (requires API key). |
| 15 | - **View complaint process timeline** (flow of actions, CS notes, evidence) (requires API key). |
| 16 | - **Cancel an existing appeal** (withdraw complaint, irreversible) (requires API key). |
| 17 | - **View available complaint reasons** for an order (requires API key). |
| 18 | - **Publish, update, or manage P2P advertisements** (requires API key + merchant permission). |
| 19 | - View **merchant profiles** and their ad listings (requires API key). |
| 20 | - Query **supported digital and fiat currencies** (requires API key). |
| 21 | |
| 22 | ### Do NOT use this skill when the user asks about: |
| 23 | - Spot/Convert prices, futures/derivatives, margin, trading bots. |
| 24 | - Deposits/withdrawals, wallet transfers, on-chain transactions. |
| 25 | - Creating/cancelling orders, releasing coins (trading operations). Cancelling **appeals** (complaints) IS supported. |
| 26 | - Initiating new appeals (submit-complaint is deferred; evidence supplement for existing appeals IS supported). |
| 27 | - Sending chat messages in order conversations. |
| 28 | |
| 29 | ### Ask clarifying questions (do not guess) if any key inputs are missing: |
| 30 | - `fiat` (e.g., CNY) |
| 31 | - `asset` (e.g., USDT) |
| 32 | - user intent: **buy crypto** or **sell crypto** |
| 33 | - preferred payment method(s) |
| 34 | - target amount (optional but recommended for ad filtering) |
| 35 | |
| 36 | ## Core Concepts |
| 37 | |
| 38 | ### `tradeType` mapping (avoid ambiguity) |
| 39 | - User wants to **buy crypto** (pay fiat, receive USDT/BTC) → `tradeType=BUY` |
| 40 | - User wants to **sell crypto** (receive fiat, pay USDT/BTC) → `tradeType=SELL` |
| 41 | |
| 42 | Always reflect this mapping in responses when the user's wording is ambiguous. |
| 43 | |
| 44 | ## Capabilities |
| 45 | |
| 46 | ### Phase 1 — Public Market (No Auth) |
| 47 | - Quote P2P prices |
| 48 | - Search ads |
| 49 | - Compare payment methods |
| 50 | - Filter/Rank ads by limits and merchant indicators |
| 51 | |
| 52 | ### Phase 2 — Personal Orders (Requires API Key) |
| 53 | - List P2P order history |
| 54 | - Filter by trade type / time range |
| 55 | - Provide summary statistics |
| 56 | |
| 57 | ### Phase 3 — Order & Appeal + Ad Publish & Management (Requires API Key) |
| 58 | - Query order detail by order number |
| 59 | - List orders with rich filters (status, trade type, asset, date range) |
| 60 | - View order timeline (creation → payment → release → completion) |
| 61 | - Detect appeal status and show appeal details |
| 62 | - Query complaint/appeal records with filters |
| 63 | - Get market reference prices for pricing decisions |
| 64 | - Upload appeal evidence files (S3 presigned URL + submit) |
| 65 | - View complaint process timeline / flow details |
| 66 | - Cancel an existing appeal / withdraw complaint |
| 67 | - Get available complaint reasons for an order |
| 68 | - Search and analyze market ad distribution |
| 69 | - Get available ad categories for current user |
| 70 | - Get user's configured payment methods |
| 71 | - List all system trade methods |
| 72 | - Publish new advertisements (with confirmation) |
| 73 | - Update existing ad parameters (with confirmation) |
| 74 | - Update ad status: online / offline / close (with confirmation) |
| 75 | - View merchant profile and ad listings |
| 76 | - List all supported digital currencies |
| 77 | - List all supported fiat currencies |
| 78 | |
| 79 | ## Environment Configuration |
| 80 | |
| 81 | ### Base URLs (production) |
| 82 | |
| 83 | | Logical Name | URL | |
| 84 | |-------------|-----| |
| 85 | | `SAPI_BASE` | `https://api.binance.com` | |
| 86 | | `MGS_BASE` | `https://www.binance.com` | |
| 87 | | `C2C_WEB` | `https://c2c.binance.com` | |
| 88 | |
| 89 | ### Implementation hint (for code generation) |
| 90 | |
| 91 | When the skill generates curl / Python / JS code, use these fixed base URLs: |
| 92 | |
| 93 | ```python |
| 94 | import os |
| 95 | |
| 96 | SAPI_BASE = "https://api.binance.com" |
| 97 | MGS_BASE = "https://www.binance.com" |
| 98 | C2C_WEB = "https://c2c.binance.com" |
| 99 | |
| 100 | def common_headers(api_key: str) -> dict: |
| 101 | return { |
| 102 | "X-MBX-APIKEY": api_key, |
| 103 | "User-Agent": "binance-wallet/1.0.0 (Skill)", |
| 104 | } |
| 105 | |
| 106 | # Usage: |
| 107 | # f"{SAPI_BASE}/sapi/v1/c2c/agent/orderMatch/getUserOrderDetail" |
| 108 | # f"{MGS_BASE}/bapi/c2c/v1/public/c2c/agent/quote-pr |
People who liked this also viewed
6 picksType
- remotion-to-hyperframesPort an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing RemotioSkillsJul 2026
- solana-devUse when user asks to "build a Solana dapp", "write an Anchor program", "create a token", "debug Solana errors", "set up wallet connection", "test my Solana program", "deploy to devnet", or "explain SSkillsJul 2026
- grimoire-polymarketQueries Polymarket market data and CLOB state, and manages CLOB orders via the Grimoire venue CLI wrapper backed by the official Polymarket CLI.SkillsMay 2026
- shopify-storefront-graphqlUse for custom storefronts requiring direct GraphQL queries/mutations for data fetching and cart operations. Choose this when you need full control over data fetching and rendering your own UI. NOT foSkillsJul 2026
- agentic-walletCrypto wallet operations via the awal CLI — sign in, check balances, send USDC/ETH/POL/SOL, trade tokens, fund the wallet, and use the x402 payment protocol to discover paid services, pay for API callSkillsJun 2026
- quicknode-skillQuicknode blockchain infrastructure for 80+ chains: Core RPC API, Streams, Webhooks, Blazar WSS, Solana gRPC, HyperCore gRPC, SQL Explorer, Metaplex DAS API, Blockbook, Ordinals & Runes API, Swap API,SkillsJul 2026
