For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/gateway/execute-ramp-transfer.md.
Execute a ramp's on-chain transfer
Submits the signed transfer, sending the stablecoin to the provider. Once it lands, the provider settles the fiat leg and the ramp's status follows. Offramps only.
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*stringRamp 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
The prepared transfer and the signatures over its payloads
transfer_id*stringTransfer ID returned by the prepare endpoint
signatures*array<string>One stamp per payload, in the same order as the payloads returned by the prepare 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 executed successfully
application/json- response
The settled on-chain transfer to the provider
tx_hash*stringchain*stringasset*stringfrom*stringto*stringsent*stringfee*stringreceived*stringcurl -X POST 'https://api.truemarkets.co/v1/gateway/ramps/497f6eca-6276-4993-bfeb-53cbbbba6f08/execute' \ -H 'TM-On-Behalf-Of: 3f6d2c0e-8a41-4c2b-9f1e-2b7d5c0a9e11' \ -H 'Content-Type: application/json' \ -d '{ "transfer_id": "string", "signatures": [ "string" ], "auth_type": "api_key"}'{ "tx_hash": "string", "chain": "string", "asset": "string", "from": "string", "to": "string", "sent": "string", "fee": "string", "received": "string"}Prepare a ramp's on-chain transfer POST
Returns the unsigned payloads that send the user's stablecoin to the provider's deposit address. Call this once the provider page has been completed, and after the bridge plan if the create response returned one. Offramps only.
List allocations GET
Returns a paginated list of the caller's allocations, newest first.