Convert Currency

API Documentation · Zypher Global

Generate credentials

Convert your balance between BRL, MXN, USDT at the current rate. Two-step flow: /conversion/simulate returns the quote without touching the balance; /conversion executes (debits the source, credits the destination).

1. Simulate

POST /conversion/simulate · permission cashin

Body
{
  "amount": 1000.00,
  "from": "BRL",
  "to": "MXN"
}
Response
{ "ok": true, "rate": 3.42, "estimated_amount": 3402.90, "fee": 5.00, "from": "BRL", "to": "MXN" }

2. Execute

POST /conversion · permission cashin

Same body as the simulation. Requires a verified (KYC) account. The final amount uses the rate at execution time (may differ from the simulation).

Response
{ "ok": true, "converted_amount": 3402.90, "rate": 3.42, "fee": 5.00, "from": "BRL", "to": "MXN", "status": "confirmed" }
The conversion fee (fee) is deducted from the source before applying the rate. Insufficient balance in the source currency returns an error without debiting anything.
Was this page helpful?