Visão Geral da API de Pedidos

POST API pública para integrações com carteiras não custodiais.

URL base

https://api.tronzap.com

Todos os endpoints aceitam e retornam JSON.

Cabeçalhos obrigatórios

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

Nenhum cabeçalho de autenticação é necessário. A API de Pedidos é totalmente pública.

Limites de requisições

• 1 requisição por segundo por IP em todos os endpoints /v1/orders*.
• Exceder o limite retorna HTTP 429 Too Many Requests.
• Não é possível criar um segundo pedido ativo para o mesmo par address_from + address_to enquanto o pedido anterior ainda estiver no status new.

Envelope de resposta

Toda resposta bem-sucedida encapsula o payload em um envelope consistente:

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

Campo	Tipo	Descrição
code	integer	0 em caso de sucesso, diferente de zero em caso de erro. Veja Códigos de Erro.
request_id	string	UUID único para esta requisição. Inclua ao reportar problemas.
result	object	Payload específico do endpoint.

Endpoints

Método	Endpoint	Descrição
POST	/v1/orders/calculate	Calcular preço sem criar um pedido
POST	/v1/orders	Criar um pedido e obter um endereço de depósito
POST	/v1/orders/check	Verificar status do pedido
POST	/v1/orders/cancel	Cancelar um pedido no status new

O campo referral_code

Ganhe comissões — sempre envie referral_code

Inclua seu referral_code no corpo de cada requisição POST /v1/orders. Pedidos sem um código de referência válido não são atribuídos a nenhuma conta de parceiro e não geram comissão.

Veja Cadastro de Parceiro para obter seu código.