API docs by Redocly

P2P Market (1.0.0)

Download OpenAPI specification:

Get started

P2P Market Integration API provides programmatic access to the P2P trading platform.

This API allows integrators to:

  • Retrieve real-time list of active buy/sell ads
  • Filter ads by cryptocurrency, fiat currency, and trade direction
  • Access trader statistics and payment methods

Authorization

The API key must be provided in the X-API-Key HTTP header.

Example:

curl -X 'POST' \
'https://p2p.walletbot.me/p2p/integration-api/v1/item/online' \
-H 'accept: application/json' \
-H 'X-API-Key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"cryptoCurrency": "USDT",
"fiatCurrency": "RUB",
"side": "SELL",
"page": 1,
"pageSize": 10
}'

HTTP status codes

The table below describes the possible HTTP response codes you can receive when sending an API request.

Code Description
200 Valid request, check status in response body
400 Invalid request (e.g., unsupported currency)
401 Invalid API key
403 Access denied
404 Invalid API path
429 Request limit reached
503 Service temporarily unavailable
5xx Unexpected error

Item

Get online items (ads)

Returns a list of online items (ads) filtered by token, currency and side

Authorizations:
apiKeyAuth
Request Body schema: application/json
required
cryptoCurrency
required
string

Cryptocurrency code

fiatCurrency
required
string

Fiat currency code

side
required
string
Enum: "BUY" "SELL"

Trade side: BUY or SELL

page
integer
Default: 1

Page number (optional, default 1)

pageSize
integer
Default: 10

Items per page (optional, default 10, max 50)

Responses

Request samples

Content type
application/json
{
  • "cryptoCurrency": "USDT",
  • "fiatCurrency": "RUB",
  • "side": "SELL",
  • "page": 1,
  • "pageSize": 10
}

Response samples

Content type
application/json
{
  • "status": "SUCCESS",
  • "data": [
    ]
}