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

Organization tokenNo token

POST
/custody/releases

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.

Authorization

bearerAuth
headerAuthorizationBearer <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.

Header Parameters

TM-On-Behalf-Of?string

Act 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.

Formatuuid

Request Body

application/json
  1. body

Request to release allocated balance from CeFi trading

asset_id*string

DeFi listing identifier (UUID)

Formatuuid
amount*string

Amount to release, as a positive decimal string

Response Body

Release accepted

application/json
  1. response

A release and the CeFi transfer it started.

id*string

Release identifier

Formatuuid
status*ReleaseStatus

Where 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.
Value in"debiting""completed""rejected""stranded"
asset_id*string

DeFi listing identifier (UUID)

Formatuuid
asset_symbol*string

Symbol of the listing

amount*string

Amount freed by this release, as a decimal string

transfer?

The CeFi transfer an allocation or release started, under the exchange's id

failure_reason?string

Why the release was refused or stranded

created_at*string
Formatdate-time
updated_at*string
Formatdate-time
Example Request
curl -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"}'
Example Response
{  "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"}