Builders · REST

The /v1 contract machines pay against.

Bearer auth. Prepaid credits. Async runs with poll. Every response includes data, provenance, and usage.

Get API key · 150 free credits OpenAPI.json Builders hub
Auth

Production and sandbox

Authorization: Bearer ysa_prod_YOUR_KEY

Sandbox keys (ysa_test_*) return mock runs and charge $0. Same host. Not a separate stack. Create keys at Developer → API Keys.

Base URL

api.ysaere.com

https://api.ysaere.com/v1
Cheapest pull

Angel · 50 credits

Shell
curl -sS -X POST https://api.ysaere.com/v1/intel/angel-report \
  -H "Authorization: Bearer $YSAERE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"Acme Robotics"}'

# then poll
curl -sS https://api.ysaere.com/v1/reports/RUN_ID \
  -H "Authorization: Bearer $YSAERE_API_KEY"
Also live

Account, provenance, marketplace

GET /v1/account/balance

GET /v1/reports/:id/provenance · integrity receipt

POST /v1/marketplace/agents/:slug/run

Prefer CLI / SDK? Prefer MCP?