Skip to content
Hightop docs header art
Hightop
API and Integrations

/conversions

POST/v1/agent/conversions

Execute a conversion from a quote

Requires API-key authentication (agentAuth, agentId).

Purpose: execute a conversion using a previously created quote.

Auth and scope: header-key auth or OAuth agent:conversions:write.

Idempotency: required.

Request:

json
example
{
  "quote_id": "uuid"
}

Response:

json
example
{
  "ok": true,
  "operation_id": "uuid",
  "status": "submitted",
  "resource": {
    "type": "conversion",
    "id": "uuid"
  },
  "fee_usd": "0"
}

Common errors: quote_expired, quote_already_consumed, slippage_exceeded, price_stale, insufficient_funds, permission_not_granted.

Related recipe: Convert with a Quote.