Skip to main content
POST
/
agent
/
{walletAddress}
/
chat
Agent runtime
curl --request POST \
  --url https://api.compose.market/agent/{walletAddress}/chat

Documentation Index

Fetch the complete documentation index at: https://docs.compose.market/llms.txt

Use this file to discover all available pages before exploring further.

Agent runtime routes proxy to the runtime service after preparing payment. They accept Compose Key bearer auth or raw x402 payment headers.

​
Routes

MethodPathStreamingDescription
POST/agent/{walletAddress}/chatNoRuns one JSON chat call.
POST/agent/{walletAddress}/streamYesRuns one streaming chat call.
POST/agent/{walletAddress}/responsesNoRuns one Responses-style agent call.
GET/agent/{walletAddress}/runs/{runId}/stateNoReads runtime state for one run.
POST/agent/{walletAddress}/runs/{runId}/stopNoStops one runtime run.

​
Path parameters

​
walletAddress
string
required
Agent wallet address.
​
runId
string
Runtime run ID for state and stop routes.

​
Headers

​
Authorization
string
Bearer compose-... for Compose Key billing.
​
PAYMENT-SIGNATURE
string
Raw x402 payment signature.
​
x-x402-max-amount-wei
string
Maximum USDC atomic amount for raw x402 upto payments.

​
Settlement

RouteMeter source
/chatJSON response body usage.
/responsesJSON response body usage and modality.
/streamTerminal SSE event with type: done, type: stopped, or type: error.
Streaming routes emit a compose.receipt event before closing when settlement succeeds.