Orders API Übersicht

POST Öffentliche API für nicht-verwahrende Wallet-Integrationen.

Basis-URL

https://api.tronzap.com

Alle Endpunkte akzeptieren und geben JSON zurück.

Erforderliche Header

Content-Type: application/json
Accept: application/json

Es sind keine Authentifizierungs-Header erforderlich. Die Orders API ist vollständig öffentlich.

Rate-Limits

• 1 Anfrage pro Sekunde pro IP für alle /v1/orders*-Endpunkte.
• Bei Überschreitung des Limits wird HTTP 429 Too Many Requests zurückgegeben.
• Du kannst keinen zweiten aktiven Auftrag für dasselbe address_from + address_to-Paar erstellen, solange der vorherige Auftrag noch den Status new hat.

Antwort-Envelope

Jede erfolgreiche Antwort kapselt die Nutzlast in einem einheitlichen Envelope:

{
  "code": 0,
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "result": {}
}

Feld	Typ	Beschreibung
code	integer	0 bei Erfolg, ungleich null bei Fehler. Siehe Fehlercodes.
request_id	string	Eindeutige UUID für diese Anfrage. Bei der Fehlermeldung angeben.
result	object	Endpunkt-spezifische Nutzlast.

Endpunkte

Methode	Endpunkt	Beschreibung
POST	/v1/orders/calculate	Preis berechnen ohne einen Auftrag zu erstellen
POST	/v1/orders	Auftrag erstellen und eine Einzahlungsadresse erhalten
POST	/v1/orders/check	Auftragsstatus abfragen
POST	/v1/orders/cancel	Auftrag stornieren im Status new

Das Feld referral_code

Provisionen verdienen — referral_code immer übergeben

Füge deinen referral_code in jeden POST /v1/orders-Anfrage-Body ein. Aufträge ohne gültigen Empfehlungscode werden keinem Partner-Konto zugeordnet und erhalten keine Provision.

Siehe Partner-Onboarding, um deinen Code zu erhalten.