Orders API Overview

POST Public API for non-custodial wallet integrations.

Base URL

https://api.tronzap.com

All endpoints accept and return JSON.

Required headers

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

No authentication headers are required. The Orders API is fully public.

Rate limits

• 1 request per second per IP across all /v1/orders* endpoints.
• Exceeding the limit returns HTTP 429 Too Many Requests.
• You cannot create a second active order for the same address_from + address_to pair while the previous order is still in new status.

Response envelope

Every successful response wraps the payload in a consistent envelope:

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

Field	Type	Description
code	integer	0 for success, non-zero on error. See Error Codes.
request_id	string	Unique UUID for this request. Include it when reporting issues.
result	object	Endpoint-specific payload.

Endpoints

Method	Endpoint	Description
POST	/v1/orders/calculate	Calculate price without creating an order
POST	/v1/orders	Create an order and get a deposit address
POST	/v1/orders/check	Check order status
POST	/v1/orders/cancel	Cancel an order in new status

The referral_code field

Earn commissions — always pass referral_code

Include your referral_code in every POST /v1/orders request body. Orders without a valid referral code are not attributed to any partner account and earn no commission.

See Partner Onboarding to obtain your code.