x402 Payments

Caesar supports x402 so you can pay for research jobs per request without pre-provisioning an API key. The /x402/research endpoint verifies an x402 payment, creates a scoped API key that only works for the resulting ask, and returns that secret in the response. You can then call any standard Caesar endpoint with that key to retrieve results or fetch content.

How the flow works

1. Prepare an x402 payment payload using your wallet or facilitator client (see the x402 quickstart for language-specific helpers).
2. POST to /x402/research with the payment payload and your research request.
3. Receive a response containing the research job ID, status, and a temporary api_key_secret.
4. Use the returned API key as a Bearer token to call standard Caesar endpoints (e.g., GET /research/{id} or GET /research/{id}/results/{resultId}/content).
5. Once the research completes, revoke the key (it is already scoped to the single ask and expires automatically after settlement).

Requesting research with x402

1
curl -X POST https://api.caesar.xyz/x402/research \
2
     -H "X-PAYMENT: X-PAYMENT" \
3
     -H "Content-Type: application/json" \
4
     -d '{
5
  "query": "What are the latest advancements in renewable energy technologies?"
6
}'

The endpoint accepts the same body as POST /research. The key difference is the required X-PAYMENT header:

1
POST /x402/research HTTP/1.1
2
Host: api.caesar.xyz
3
Content-Type: application/json
4
X-PAYMENT: {{base64-encoded x402 payload}}
5
6
{
7
  "query": "Summarise the latest trends in agentic tooling for autonomous research",
8
  "compute_units": 2,
9
  "system_prompt": "Return a concise executive summary with bullet-point recommendations."
10
}

The service verifies the payment, settles it, enqueues the ask, and returns the temporary key:

1
{
2
  "id": "f2f6e5db-2c7d-4f56-bb0c-5a6b6a7a9b10",
3
  "status": "queued",
4
  "api_key_secret": "sk-temp-x402-demo-secret"
5
}

Using the scoped API key

Treat the returned api_key_secret exactly like a normal Caesar API key, but remember it is scoped to a single ask. Any request that references the original ask ID will succeed; other operations will be rejected.

$
curl "https://api.caesar.xyz/research/f2f6e5db-2c7d-4f56-bb0c-5a6b6a7a9b10" \
>
  -H "Authorization: Bearer sk-temp-x402-demo-secret"

Troubleshooting

Additional resources