Introduction
L'API p3p est une interface HTTP/JSON publique pour l'exchange cross-chain p3p. Elle te permet de :
- Récupérer les chaînes, tokens et taux de marché en direct supportés
- Coter et exécuter des swaps à travers plusieurs sources de liquidité agrégées
- Accepter des paiements en tant que marchand via des factures, avec des fonds réglés directement vers ton portefeuille
p3p est non-custodial : l'API ne détient jamais les fonds de l'utilisateur au-delà des quelques secondes nécessaires pour router un swap, et tu n'as jamais besoin de partager des clés privées ou d'effectuer un KYC.
URL de base
https://api.p3p.xyzModèle d'authentification
p3p a deux types d'utilisateurs distincts avec des exigences d'authentification différentes.
Développeurs
Les développeurs créant des applications qui exécutent des swaps de manière programmatique (récupération des chaînes, tokens, taux, création d'exchanges) doivent inclure un en-tête api-key valide sur chaque requête.
api-key: your_api_key_here| Cas d'utilisation | Ce dont tu as besoin |
|---|---|
| Récupérer chaînes, tokens, taux | En-tête api-key |
| Coter un swap | En-tête api-key |
| Exécuter un swap | En-tête api-key |
| Gagner une part des revenus sur les swaps | En-tête api-key + opts.partner_id réglé sur ton portefeuille |
Pour obtenir une clé API, contacte-nous sur Telegram.
Marchands
Les marchands acceptent les paiements crypto via des factures. Pas de clé API requise — ton adresse de portefeuille est ton identité.
| Cas d'utilisation | Ce dont tu as besoin |
|---|---|
| Créer une facture | Ton adresse de portefeuille comme wallet_merchant dans le corps |
| Voir tes factures / tes gains | Ton adresse de portefeuille dans l'URL des endpoints partner |
Pas d'inscription. Pas de tokens. Juste utiliser ton portefeuille. Voir le guide Marchands.
Format de réponse
Chaque endpoint retourne du JSON.
Succès :
{ "id": "ex_...", "status": "waiting", "...": "..." }Erreur :
{ "error": "wallet_to_invalid", "message": "wallet_to has invalid address: ..." }Limites de taux
Si tu reçois HTTP 429, ralentis ou contacte-nous pour augmenter la limite pour ton projet.