Conversions
Create and poll conversions on the company omnibus wallet.
| Method | Path | Scope |
|---|---|---|
POST | /partner/v1/conversions | conversions:write |
GET | /partner/v1/conversions?clientOrderId=… | conversions:read |
GET | /partner/v1/conversions/:id | conversions:read |
Create
{
"sourceSymbol": "USDT",
"targetSymbol": "BTC",
"amount": "100.5",
"externalUserId": "user-42",
"clientOrderId": "ord_9f3c2a"
}
- Debits the company actor bound to the key.
externalUserIdis correlation-only (your end-user id).clientOrderIdis the idempotency key. Retries with the same value return the original conversion.
Lookup
- By partner idempotency key:
GET /partner/v1/conversions?clientOrderId=ord_9f3c2a - By Danatorex id:
GET /partner/v1/conversions/101
Response fields include amounts, fills, fee, status, refId, and timestamps.
Terminal status
When a conversion reaches a terminal status, Danatorex also delivers a signed webhook (conversion.terminal). You may still poll GET endpoints. See Webhooks.