Getting Started

A quick map of what you do with the p3p API, in order.

1. Get your API key

Contact us on Telegram to request a key. You will receive a string like:

YOUR_P3P_API_KEY

2. Attach it to requests

Send your key as the api-key header on every endpoint call:

api-key: YOUR_P3P_API_KEY

3. Executions

Pick the surface you need.

3.1. Exchange

Crypto ↔ Crypto - Aggregated cross chain swaps with best rates.

• Get Chains — what chains are live
• Get Tokens — tokens grouped by chain
• Get Rates — live oracle reference rates
• Quote Exchange Rate — best aggregated quote across all liquidity sources
• Create Exchange — lock the rate and get a deposit address

3.2. Trade

Fiat ↔ Crypto - Same exchange engine, with a fiat asset on one side.

• Get Fiats — fiat currencies available
• Quote Trade Rate — fiat→crypto or crypto→fiat quote
• Create Trade — lock the rate and get payment instructions

3.3. Merchant

Payment Provider - Accept payments in your projects, charge customers in any token and receive a different one in your wallet.

• Create Invoice — programmatic checkout
• Create Shareable Invoice URL — QR code / link
• Get Partner Stats, Exchanges, Invoices

4. Status

Whatever you launched in step 3 (Executions), you track it the same way:

• Check Exchange Status — single trade
• Check Multiple Exchanges Status — batch poll

5. Earn revenue

Attribution and your fee are driven entirely by which api-key you authenticate with — not by anything in the request body. Register at the Partner Dashboard, set your fee %, and send your partner key as the api-key header on every /exchange/rate and /exchange/create call:

api-key: YOUR_PARTNER_API_KEY

When that key is present, the trade is attributed to you and your fee is automatically deducted from the output (amount_to) on top of the platform fee — the quote you receive already reflects it. Revenue accrues to your fee wallets / payout schedule.

Use your partner key, not a generic dev key

A generic developer key lets you call the endpoints but is not a partner, so no fee is applied and nothing is attributed to you. Only the partner key issued in your dashboard earns revenue. Get yours at the Partner Dashboard.

opts.partner_id is ignored

Identity is taken only from the api-key header. Any partner_id you put in the request body is ignored for attribution and fee purposes — older examples that set it no longer apply. (Merchant invoices are the one exception: /invoice/create still identifies the merchant by wallet_merchant.)

Configure your fee, fee wallets, and payout schedules at the Partner Dashboard. Inspect what you earned with the partner endpoints.