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

Organization tokenNo token

POST
/ramps/{id}/execute

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.

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.

Path Parameters

id*string

Ramp ID (UUID)

Formatuuid

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

The prepared transfer and the signatures over its payloads

transfer_id*string

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

Items1 <= items
auth_type*SigningMethod

The 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.
Value in"web_authn""api_key"

Response Body

Transfer executed successfully

application/json
  1. response

The settled on-chain transfer to the provider

tx_hash*string
chain*string
asset*string
from*string
to*string
sent*string
fee*string
received*string
Example Request
curl -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"}'
Example Response
{  "tx_hash": "string",  "chain": "string",  "asset": "string",  "from": "string",  "to": "string",  "sent": "string",  "fee": "string",  "received": "string"}