Panoramica dell'Orders API

POST API pubblica per integrazioni con wallet non-custodial.

URL di base

https://api.tronzap.com

Tutti gli endpoint accettano e restituiscono JSON.

Header richiesti

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

Non sono richiesti header di autenticazione. L'Orders API è completamente pubblica.

Limiti di frequenza

• 1 richiesta al secondo per IP su tutti gli endpoint /v1/orders*.
• Il superamento del limite restituisce HTTP 429 Too Many Requests.
• Non puoi creare un secondo ordine attivo per la stessa coppia address_from + address_to mentre l'ordine precedente è ancora in stato new.

Envelope di risposta

Ogni risposta riuscita racchiude il payload in un envelope consistente:

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

Field	Type	Description
code	integer	0 per successo, non zero in caso di errore. Vedi Codici di Errore.
request_id	string	UUID univoco per questa richiesta. Includilo quando segnali problemi.
result	object	Payload specifico dell'endpoint.

Endpoint

Method	Endpoint	Description
POST	/v1/orders/calculate	Calcola il prezzo senza creare un ordine
POST	/v1/orders	Crea un ordine e ottieni un indirizzo di deposito
POST	/v1/orders/check	Controlla lo stato dell'ordine
POST	/v1/orders/cancel	Annulla un ordine in stato new

Il campo referral_code

Guadagna commissioni — passa sempre referral_code

Includi il tuo referral_code nel corpo di ogni richiesta POST /v1/orders. Gli ordini senza un codice referral valido non vengono attribuiti ad alcun account partner e non fanno guadagnare alcuna commissione.

Vedi Onboarding Partner per ottenere il tuo codice.