Documentation API

Aujourd’hui

/api Ouvert

API versionnee

/api/v1 Contrat publie, non ouvert

La version est dans le chemin, pas dans un en-tete : une URL doit pouvoir etre collee dans un ticket sans perdre son contexte. Une modification cassante — champ retire, type change, semantique differente — ouvre une nouvelle version ; l’ancienne reste servie pendant au moins six mois, avec sa date de fin annoncee dans le journal des versions. Ajouter un champ n’est pas cassant : votre client doit ignorer les champs qu’il ne connait pas.

curl -sS -X POST https://fiatside.com/api/quote \
  -H 'Content-Type: application/json' \
  -d '{
    "assetId": "usdt",
    "railId": "sepa_instant",
    "networkId": "tron",
    "direction": "sell",
    "amount": "1000"
  }'

{
  "deposit": { "amount": "1000.000000", "ticker": "USDT", "decimals": 6 },
  "gross": "921.68",
  "net": "912.28",
  "currency": "EUR",
  "currencyDecimals": 2,
  "midRate": "0.92168430",
  "effectiveRate": "0.91228000",
  "totalCostBps": 102,
  "lines": [
    { "code": "network", "amount": "1.11", "basis": "Cout reseau tron, preleve en USDT" },
    { "code": "spread",  "amount": "8.29", "basis": "0.90 % du montant converti" }
  ],
  "settlement": { "p50Minutes": 1, "p95Minutes": 12 },
  "lockSeconds": 1800,
  "rateAsOf": 1788356981608,
  "rateSource": "mock",
  "limitError": null
}

Le champ rateSource indique la source du prix. La valeur « mock » designe la source deterministe de developpement, qui ne peut pas demarrer en production : le processus refuse de se lancer plutot que de coter des prix figes.

• AuthentificationComment l’endpoint de cotation est protege aujourd’hui, comment les cles seront emises, et les regles de manipulation d’une cle de production.
• CotationL’endpoint de cotation, sa decomposition ligne a ligne, la gestion des limites de rail et la duree de verrouillage du taux.
• CommandesCreation d’une commande, cle d’idempotence, adresse de depot, memo obligatoire sur certains reseaux, et lecture des transitions d’etat.
• ReferentielsCatalogues de rails, d’actifs et de pays, schema de champs du beneficiaire pour generer votre formulaire de payout, et pagination par curseur.
• WebhooksEvenements emis, signature HMAC-SHA256, fenetre de rejeu, politique de reessai et verification en temps constant.
• ErreursChaque code d’erreur, son statut HTTP, ce qu’il signifie exactement, la conduite a tenir cote integration et lesquels meritent un reessai.

• Aucun payout vers un tiers. Le nom du beneficiaire doit correspondre a l’identite verifiee du titulaire de la commande, et les rails de paiement rapprochent desormais le nom et le compte.
• Aucune creation de compte ni verification d’identite par API. Ces etapes se font dans un parcours ou l’utilisateur voit ce qu’il accepte.
• Aucune cle en parametre d’URL. Les URL finissent dans les journaux, les en-tetes de referrer et les historiques : une cle passee ainsi est une cle a revoquer.
• Aucune mise en cache d’une cotation par nos soins. La reponse porte Cache-Control: no-store, et votre integration ne devrait pas la contourner : une cotation en cache est un prix perime presente comme ferme.
• Aucun endpoint d’achat de crypto. Le service va dans un seul sens, actif numerique vers monnaie ayant cours legal.