For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/gateway/execute-transfer.md.
Execute pending transfer
Executes a transfer in awaiting_signature status using client-provided signatures
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.
id*stringTransfer ID (UUID)
uuidTM-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 execute a transfer that is in awaiting_signature status. The client must sign each payload returned by the create endpoint and submit the signatures in the same order.
signatures*array<string>One stamp per payload, in the same order as the payloads returned by the create endpoint. With auth_type: api_key, an entry is the base64url encoding, without padding, of the JSON {"publicKey": "<compressed P-256 public key, hex>", "signature": "<DER signature, hex>", "scheme": "SIGNATURE_SCHEME_TK_API_P256"}, signed as UnsignedPayload describes. With auth_type: web_authn, an entry is the browser's WebAuthn stamp.
1 <= itemsauth_type*SigningMethodThe authentication method used to sign transaction payloads.
- web_authn — Signed using a passkey (WebAuthn/FIDO2 credential) via the browser.
- api_key — Signed using an API key. Suitable for programmatic/headless access.
"web_authn""api_key"Transfer execution initiated
application/json- response
Canonical representation of a transfer.
id*stringUnique transfer identifier
uuidstatus*TransferStatusThe current status of the transfer.
- awaiting_signature — Transfer has been created and is waiting for the client to sign the unsigned payloads and call the execute endpoint.
- pending — Signed transaction has been submitted and is awaiting on-chain confirmation.
- completed — Transfer has been confirmed on-chain.
- failed — Transfer failed due to an on-chain error or rejection.
"awaiting_signature""pending""completed""failed"venue*VenueThe trading venue to filter by.
- defi — Decentralized exchange (on-chain swaps).
- cefi — Centralized exchange (off-chain order book).
"defi""cefi"asset_id*stringAsset identifier
uuidasset_symbol*stringAsset ticker symbol (e.g. USDC, SOL)
chain*|Blockchain network (e.g. solana, base) for DeFi transfers, or null for CeFi transfers
network*|Destination network the CeFi withdrawal was submitted on (one of the asset's supported networks from GET /assets), or null for DeFi transfers.
to*stringDestination wallet address
qty*stringTransfer quantity as a decimal string
qty_unit*stringUnit of the quantity
"base""quote"sent*stringAmount sent as a decimal string
fee*stringFee as a decimal string
received*stringAmount received as a decimal string
tx_hash*stringOn-chain transaction hash
explorer_url?|Public block-explorer page for tx_hash, null until the transfer is broadcast
payloads*array<>Unsigned transaction payloads for the client to sign. Present when status is awaiting_signature; empty array after execution.
created_at*stringTimestamp when the transfer was created (RFC 3339)
date-timeupdated_at*stringTimestamp of the last status update (RFC 3339)
date-timecurl -X POST 'https://api.truemarkets.co/v1/gateway/transfers/497f6eca-6276-4993-bfeb-53cbbbba6f08/execute' \ -H 'TM-On-Behalf-Of: 3f6d2c0e-8a41-4c2b-9f1e-2b7d5c0a9e11' \ -H 'Content-Type: application/json' \ -d '{ "signatures": [ "string" ], "auth_type": "api_key"}'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "status": "pending", "venue": "defi", "asset_id": "b4695157-0d1d-4da0-8f9e-5c53149389e4", "asset_symbol": "string", "chain": "string", "network": "bitcoin", "to": "string", "qty": "string", "qty_unit": "base", "sent": "string", "fee": "string", "received": "string", "tx_hash": "string", "explorer_url": "string", "payloads": [ { "digest": "string", "payload": "string" } ], "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}