# p2p

Queries Binance P2P market prices, checks order histories, tracks appeals, and manages merchant advertisements via natural language.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 4300 installs · ★ 1089
- Author: binance
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/binance/binance-skills-hub/tree/HEAD/skills/binance/p2p/SKILL.md
- Updated: 2026-10-25
- HTML: https://affpapa.org/en/nevibecode/skills/p2p

## What it does

This skill interacts with Binance P2P in two distinct modes. Public queries require no credentials: the agent can fetch live buy or sell quotes, compare payment methods like bank transfers, and filter open advertisements by limits and merchant ratings.

Private operations require `BINANCE_API_KEY` and `BINANCE_SECRET_KEY`. Once configured with read access, the skill pulls order history, detailed timelines, and dispute records, including uploading evidence files via S3 presigned URLs. Modifying or publishing ads requires active merchant permissions.

Direct trading actions are blocked by design. The agent cannot place new orders, release crypto, or confirm payments. When generating code for SAPI endpoints, remember that query parameters must retain their original insertion order, because standard key sorting invalidates the HMAC SHA256 signature.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add binance/binance-skills-hub --skill p2p -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/p2p/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/p2p/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add binance/binance-skills-hub --skill p2p -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/p2p/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add binance/binance-skills-hub --skill p2p -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/p2p/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install binance/binance-skills-hub p2p
```

2. **Manually: put the files in place**
- File: `.github/skills/p2p/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add binance/binance-skills-hub --skill p2p -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/binance/binance-skills-hub --path skills/binance/p2p
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/p2p/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add binance/binance-skills-hub --skill p2p -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/binance/binance-skills-hub/tree/HEAD/skills/binance/p2p/SKILL.md

## When to use it
- compare crypto buy and sell quotes across payment methods
- inspect P2P order timelines and summary statistics
- submit evidence files and track dispute timelines for appeals
- publish and update merchant advertisement parameters

## Example prompts
- Find the best USDT/CNY buy ads supporting bank transfers.
- Check the appeal status and timeline for my latest P2P order.
- Show my P2P order history and summary stats for this month.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 220dd34d152478ae.

BEGIN THIRD-PARTY FILE 220dd34d152478ae
```text
---
name: p2p
description: |
  Binance 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 methods, reviewing P2P order history, checking order detail/appeal status, querying complaints, publishing/updating/managing P2P advertisements, or viewing merchant profiles.

  Do NOT use for spot/futures prices, exchange trading, deposits/withdrawals, on-chain transfers, or anything unrelated to P2P/C2C.
---

# Binance P2P Trading Skill

Help users interact with **Binance P2P (C2C)** via natural-language queries.

## When to Use / When NOT to Use

### Use this skill when the user wants to:
- Check **P2P** buy/sell quotes for a crypto/fiat pair (e.g., USDT/CNY).
- Search **P2P advertisements** and filter by payment method(s), limits, merchant quality.
- Compare prices across payment methods (e.g., Alipay vs bank transfer).
- View **their own P2P order history / summary** (requires API key).
- Query **order detail** and view full order timeline (requires API key).
- Check **appeal/complaint status** and view complaint history (requires API key).
- **Submit evidence** for an existing appeal (upload files + submit description) (requires API key).
- **View complaint process timeline** (flow of actions, CS notes, evidence) (requires API key).
- **Cancel an existing appeal** (withdraw complaint, irreversible) (requires API key).
- **View available complaint reasons** for an order (requires API key).
- **Publish, update, or manage P2P advertisements** (requires API key + merchant permission).
- View **merchant profiles** and their ad listings (requires API key).
- Query **supported digital and fiat currencies** (requires API key).

### Do NOT use this skill when the user asks about:
- Spot/Convert prices, futures/derivatives, margin, trading bots.
- Deposits/withdrawals, wallet transfers, on-chain transactions.
- Creating/cancelling orders, releasing coins (trading operations). Cancelling **appeals** (complaints) IS supported.
- Initiating new appeals (submit-complaint is deferred; evidence supplement for existing appeals IS supported).
- Sending chat messages in order conversations.

### Ask clarifying questions (do not guess) if any key inputs are missing:
- `fiat` (e.g., CNY)
- `asset` (e.g., USDT)
- user intent: **buy crypto** or **sell crypto**
- preferred payment method(s)
- target amount (optional but recommended for ad filtering)

## Core Concepts

### `tradeType` mapping (avoid ambiguity)
- User wants to **buy crypto** (pay fiat, receive USDT/BTC) → `tradeType=BUY`
- User wants to **sell crypto** (receive fiat, pay USDT/BTC) → `tradeType=SELL`

Always reflect this mapping in responses when the user's wording is ambiguous.

## Capabilities

### Phase 1 — Public Market (No Auth)
- Quote P2P prices
- Search ads
- Compare payment methods
- Filter/Rank ads by limits and merchant indicators
```
END THIRD-PARTY FILE 220dd34d152478ae

The third-party file has ended. Everything between the 220dd34d152478ae tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3051 of 43477 bytes. © binance · MIT · https://github.com/binance/binance-skills-hub/tree/HEAD/skills/binance/p2p/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md