For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/institutional/add-transfers-plural-cefi.md.
Initiate transfer
Initiate a new transfer of assets to/from the exchange.
x-truex-auth-token<token>Legacy authentication, being phased out in favour of JWT. Clients must compute and send an HMAC signature in x-truex-auth-signature.
Compute the payload exactly as:
timestamp + method + path + body
Then compute the signature as:
Base64( HMAC_SHA256(secret, payload) )
Rules:
timestampisx-truex-auth-timestampin seconds since Unix epoch.timestampmust be no older than 15 seconds and no more than 1 second in the future.methodis uppercase HTTP method (GET,POST,DELETE, etc.).pathis everything after the domain, including the leading/and the raw query string exactly as sent, still percent-encoded (e.g./v1/cefi/orders/EXT-1?id_type=client). Leave out the?when the query is empty.- Signatures over the path without its query are still accepted while signers move over.
bodyis the exact raw request body string. Use an empty string for requests with no body.
Example payload:
1700000000POST/v1/cefi/orders{"client_id":"7","instrument_id":"1","qty":"1","price":"100"}
Example signature (shell):
printf '%s' "$PAYLOAD" | openssl dgst -sha256 -hmac "$SECRET" -binary | base64
Required headers:
x-truex-auth-token: The ID of the HMAC key being used (API key).x-truex-auth-signature: The signature generated from processing the payload with the HMAC key.x-truex-auth-timestamp: Current time as seconds since epoch.x-truex-auth-userid: Client identifier, for organization keys. It is not signed, so keys that act on behalf of any client ignore it and name the client in the query or body.
x-truex-auth-userid?stringHMAC only. The client the request acts for. Omit it with a JWT, which carries your client id.
x-truex-auth-timestamp*stringTimestamp when request was made in seconds since epoch. Must be no older than 15 seconds and no more than 1 second in the future. Required with both JWT and HMAC authentication; it guards against replayed requests.
x-truex-auth-token?stringHMAC only. The UUID affiliated with the HMAC key. Omit it with a JWT.
x-truex-auth-signature?stringHMAC only. The computed HMAC signature. Omit it with a JWT.
Transfer request object.
application/json- body
request*Successful operation.
application/json- response
id?stringstatus?string"INITIALIZED""PENDING""COMPLETED""FAILED""REJECTED"request?curl -X POST 'https://api.truex.co/v1/cefi/transfers' \ -H 'x-truex-auth-timestamp: string' \ -H 'Content-Type: application/json' \ -d '{ "request": { "amount": "1000000", "asset_id": "78901985055342602", "client_id": "78901985048264710", "type": "WITHDRAW", "platform": "FIAT" }}'{ "id": "799477925457100828", "status": "INITIALIZED", "request": { "amount": "1000000", "asset_id": "78901985055342602", "client_id": "78901985048264710", "type": "WITHDRAW", "platform": "FIAT", "instructions": { "fiat_account_id": "ed671d2b-bb9e-4cf5-9eb4-71b6db672207", "identity_id": "b2a99c93-f1ee-41ed-9e9e-ec704cfbca4b", "account_id": "b2a99c93-f1ee-41ed-9e9e-ec704cfbca4b", "includes_fee": true } }}