Descripción General de la API de Órdenes

POST API pública para integraciones con wallets no custodiales.

URL base

https://api.tronzap.com

Todos los endpoints aceptan y devuelven JSON.

Encabezados requeridos

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

No se requieren encabezados de autenticación. La API de Órdenes es totalmente pública.

Límites de velocidad

• 1 solicitud por segundo por IP en todos los endpoints /v1/orders*.
• Superar el límite devuelve HTTP 429 Too Many Requests.
• No puedes crear una segunda orden activa para el mismo par address_from + address_to mientras la orden anterior sigue en estado new.

Envoltorio de respuesta

Cada respuesta exitosa envuelve el contenido en un envoltorio consistente:

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

Campo	Tipo	Descripción
code	integer	0 para éxito, distinto de cero en caso de error. Ver Códigos de Error.
request_id	string	UUID único para esta solicitud. Inclúyelo al reportar problemas.
result	object	Contenido específico del endpoint.

Endpoints

Método	Endpoint	Descripción
POST	/v1/orders/calculate	Calcular precio sin crear una orden
POST	/v1/orders	Crear una orden y obtener una dirección de depósito
POST	/v1/orders/check	Consultar estado de la orden
POST	/v1/orders/cancel	Cancelar una orden en estado new

El campo referral_code

Gana comisiones — siempre pasa referral_code

Incluye tu referral_code en el cuerpo de cada solicitud POST /v1/orders. Las órdenes sin un código de referido válido no se atribuyen a ninguna cuenta de socio y no generan ninguna comisión.

Consulta Incorporación de Socios para obtener tu código.