Skip to main content
POST
Execute an x402 agent round

Body

application/json

Agent round execution request

Request body for POST /v1/agent/execute. Agent-specific fields use snake_case.

payer
string
required

Payer Ed25519 identity and on-chain escrow authority (base58 pubkey).

Example:

"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"

canonical_timestamp
integer
required

Node round timestamp and on-chain replay key. Must be within gateway clock skew.

Example:

1700100000

signatures_required
integer
required

Requested quorum for this round.

Example:

3

amount
integer
required

Locked round price in USDC atomic units. Must equal the computed price exactly.

Example:

1030

registry_version
integer
required

Active on-chain registry version. Must match the current version.

Example:

42

apiConfig
object
required

Off-chain HTTP API configuration hashed into the feed identity.

agent_request_auth_sig
string

Payer Ed25519 signature over H(AgentRequestAuth) (base58 or 0x hex). Omit only on the unfunded first request of the 402 discovery flow.

encKeyBundle
object

End-to-end encryption envelope for private API configs. Omit for plaintext configs.

Response

Signed payload ready for submission or verification

Successful round response envelope shared by subscription and agent execute paths.

status
string

Round completion status.

Example:

"completed"

data
object

Threshold-signed oracle result included in successful round responses.