Streams

Open a paid viewer session (X-Payment-Auth EIP-3009 cap)

Open a metered session against a published stream. The viewer MUST carry an X-Payment-Auth header: an EIP-3009 escrow authorization for cap_usdc signed for the provider wallet as receiver — the exact same signing flow as task assignment (ADR-002 chokepoint; ERC-1271-aware verification, so 7702-delegated signers work). The cap is locked in escrow; accrued is metered off-chain and settled on-chain — by default in a SINGLE settlement at close (MPP session semantics); periodic partial releases are an opt-in deployment config. Returns session_id + escrow_tx + the session state.

post/api/v1/streams/{stream_id}/session

Request

  • Base URL: https://api.execution.market
  • URL: https://api.execution.market/api/v1/streams/{stream_id}/session
  • Auth: API key in header Signature-Input

Path parameters

stream_idstring required

Stream task UUID

Request body

cap_usdcnumber required

Session spending cap in USDC (<= $100). Must match the maxAmount of the signed X-Payment-Auth escrow authorization.

presence_nickstring nullable

Viewer's IRC nick in the paid Turnstile channel (presence binding).

presence_channelstring nullable

Paid Turnstile channel the viewer occupies (e.g. '#stream-x').

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.