/conversions
POST
/v1/agent/conversionsExecute a conversion from a quote
Requires API-key authentication (agentAuth, agentId).
Request body
quote_idrequired | string |
Response
okrequired | enum | true | |
operation_idrequired | string | ||
statusrequired | enum | accepted · policy_rejected · submitted · executed · execution_failed · cancelled | |
resourcerequired | object | ||
fee_usdrequired | string | ||
human_message | string | ||
policy_evaluation | object | ||
repay_amount_usd | string | ||
estimated_ltv_after | string | ||
onchain | object |
Purpose: execute a conversion using a previously created quote.
Auth and scope: header-key auth or OAuth agent:conversions:write.
Idempotency: required.
Request:
example
{
"quote_id": "uuid"
}Response:
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.