For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/gateway/create-release.md.
Release funds from CeFi
Releases amount of the caller's allocated balance from CeFi trading, so it is free to leave the caller's DeFi wallet again. This does not move tokens; to send funds out of the wallet, use POST /transfers.
Answers 202 with the release in debiting. Poll GET /custody/releases/{id} until it is completed or rejected.
Only one release per asset_id can be in progress at a time. Another request for the same asset_id answers 409, so retrying after a lost response can't release twice.
asset_id is a DeFi listing from GET /assets that also trades on CeFi. A CeFi listing answers 404.
Rate limit: counts against the Money movement limit, 20 a minute and 300 a day (user token, per user); 200 a minute and 3,000 a day (organization api key, per organization). See Rate limits.
bearerAuthAuthorizationBearer <JWT>An access token from POST /v1/auth/api-key/token. An organization token lasts one hour and has no refresh token; a personal token can be refreshed.
TM-On-Behalf-Of?stringAct as one of your organization's users. The value is the user_id returned when the user was created; the request then reads and writes that user's account. Requires an organization token and a user your organization created: 400 for a personal token, a repeated header or a non-UUID, 403 for a user outside your organization. Not accepted on organization-scoped routes.
uuidapplication/json- body
Request to release allocated balance from CeFi trading
asset_id*stringDeFi listing identifier (UUID)
uuidamount*stringAmount to release, as a positive decimal string
Release accepted
application/json- response
A release and the CeFi transfer it started.
id*stringRelease identifier
uuidstatus*ReleaseStatusWhere the release stands.
- debiting — The amount is being taken out of CeFi.
- completed — The amount is out of CeFi and free in the wallet again.
- rejected — The release was refused; the amount stays allocated.
- stranded — The outcome is unknown and support has to resolve it.
"debiting""completed""rejected""stranded"asset_id*stringDeFi listing identifier (UUID)
uuidasset_symbol*stringSymbol of the listing
amount*stringAmount freed by this release, as a decimal string
transfer?The CeFi transfer an allocation or release started, under the exchange's id
failure_reason?stringWhy the release was refused or stranded
created_at*stringdate-timeupdated_at*stringdate-timecurl -X POST 'https://api.truemarkets.co/v1/gateway/custody/releases' \ -H 'TM-On-Behalf-Of: 3f6d2c0e-8a41-4c2b-9f1e-2b7d5c0a9e11' \ -H 'Content-Type: application/json' \ -d '{ "asset_id": "b3d9e5f2-1a4c-4e7b-9f0d-2c8a6b3e5f91", "amount": "100.00"}'{ "id": "c1d2e3f4-5a6b-4c7d-8e9f-0a1b2c3d4e5f", "status": "debiting", "asset_id": "b3d9e5f2-1a4c-4e7b-9f0d-2c8a6b3e5f91", "asset_symbol": "USDC", "amount": "100.00", "transfer": { "id": "a7f3c2e1-9b4d-4e6f-8a1c-3d5e7f9b2c4a", "status": "COMPLETED" }, "failure_reason": "cefi REJECTED", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}