To further improve merchant operational efficiency and systemized management capabilities, Gate has officially launched the P2P API service.
The P2P API is an official interface service provided for verified P2P merchants. It enables merchants to securely connect their internal systems through standardized APIs and supports functions such as advertisement publishing and management, order query and processing, automatic release and cancellation of crypto orders, chat message interaction, and account information queries.
By integrating with the P2P API, merchants can achieve the following:
- Automated advertisement management and dynamic pricing adjustments
- Real-time order queries and efficient order processing
- Reduced manual operation costs and minimized operational risks
- Establishment of a 24/7 automated operational system
- Support for multi-strategy market making and scalable operations
The launch of the P2P API will further enhance the professionalism and scalability of the platform's merchant ecosystem, helping high-quality merchants improve transaction efficiency and market competitiveness.
I. Eligible Users
The P2P API is available to the following users:
- Gate merchants that have completed P2P merchant verification and passed platform review (including Certified merchants, Blue V merchants, Crown merchants, etc.)
- Merchant teams or system integrators with technical development capabilities
- Professional market-making teams that require automated trading, batch advertisement management, or multi-strategy operations
Note: Accounts that have not completed merchant verification are not eligible to use the P2P API features.
II. How to Use the P2P API
Merchant Verification
- Log in to your Gate account and navigate to the P2P Merchant Recruitment or Management page to apply to become a fiat trading merchant, such as a Regular Merchant, Blue V Merchant, or Crown Merchant etc.
- Once the merchant application is approved, merchant permissions will be activated.
Create an API Key
- Navigate to the API Key Management page (API V4 Keys) and create an API Key (ensure that P2P API permissions are enabled).
- The API Key consists of an
Access Keyand aSecret Key. Please store them securely and do not disclose them.
Note: Please keep your Secret Key secure to prevent unauthorized access.
Call the API
- Sign requests according to the official signature rules
- Use HTTPS POST requests to call the API
- Refer to the official API documentation for SDK example code
III. P2P API Functions
The Gate P2P Merchant API provides comprehensive management capabilities across core modules including accounts, ads, orders, and chat.
| Module | API | Feature |
|---|---|---|
| Account Management | POST /p2p/merchant/account/get_user_info | Retrieve basic merchant information |
| POST /p2p/merchant/account/get_myself_payment | Retrieve the list of payment methods supported by the merchant | |
| POST /p2p/merchant/account/get_counterparty_user_info | Retrieve trading counterparty user information | |
| Ads Management | POST /p2p/merchant/books/place_biz_push_order | Post ads |
| POST /p2p/merchant/books/ads_update_status | Update ads status (online/offline) | |
| POST /p2p/merchant/books/ads_detail | Retrieve advertisement details | |
| POST /p2p/merchant/books/my_ads_list | Retrieve the merchant's current ads list | |
| POST /p2p/merchant/books/ads_list | Retrieve the marketplace ads list | |
| Order Management | POST /p2p/merchant/transaction/get_pending_transaction_list | View ongoing orders |
| POST /p2p/merchant/transaction/get_completed_transaction_list | View historical orders | |
| POST /p2p/merchant/transaction/get_transaction_details | View order details | |
| POST /p2p/merchant/transaction/confirm-payment | Merchant confirms payment | |
| POST /p2p/merchant/transaction/confirm-receipt | Merchant confirms crypto release | |
| POST /p2p/merchant/transaction/cancel | Merchant cancels an order | |
| Chat Management | POST /p2p/merchant/chat/get_chats_list | Retrieve chat list / chat history |
| POST /p2p/merchant/chat/send_chat_message | Send chat messages | |
| POST /p2p/merchant/chat/upload_chat_file | Upload chat files or attachments |
IV. Support and Feedback
If you require additional P2P API support, contact our technical team through the official P2P API Telegram group. Our API administrators and community members will be happy to assist you and answer any questions.
