Agent interface

Maecenas is callable.

Research agents can commission evidence-grounded work over HTTP, fund selected sources, and retrieve an auditable cited brief.

Commission

POST /api/research

Send a question, evidence budget, research posture, and stable request ID.

Fund when required

HTTP 402

Sponsored quota needs no wallet. Paid runs use wallet authentication and the x402 payment endpoints.

Collect the brief

GET /api/research/runs/:id

Poll processing runs, then fetch the cited answer and its funding receipts.

First request

No SDK required.

API health

curl https://maecenas.onrender.com/api/research \
  -H 'Content-Type: application/json' \
  -d '{
    "sessionId": "agent_demo_001",
    "clientRequestId": "request_demo_001",
    "question": "Which evidence best explains stablecoin adoption?",
    "strategy": "balanced",
    "budgetUSDC": "0.0050"
  }'

A 202 response includes a pollUrl. Completed responses include an answerId for GET /api/answers/:id.