API & Registry

API & registry docs

Machine-readable product registry (JSON Schema v1.1.0) and REST API for catalog access, checkout, entitlements, and download delivery.

Registry schema

JSON Schema draft 2020-12. Version 1.1.0.

registry_schema_versionidtypenameversionfilescompatibilitylicenseprice_usdrisk_profile

https://api.agentartifacts.io

All endpoints accept and return JSON. Authentication via session token for protected routes.

GET

/catalog

Paginated product catalog with filter support (category, compat, mode, market_type, price range).

GET

/catalog/trading

Trading-specific catalog subset. Returns only products with execution_mode != none.

GET

/registry/index.json

Machine-readable registry index (JSON Schema v1.1.0). Paginated, sortable.

GET

/registry/products/{id}.json

Full registry metadata for a single product by ID.

GET

/registry/products/{id}/risk-profile

Risk profile payload for trading products. Returns guardrails, kill-switch config, and disclosure version.

POST

/checkout/session

Create a Stripe checkout session. Returns session URL for redirect.

POST

/leads/capture

Email lead capture for free library downloads. Stores email + tag for onboarding sequence.

POST

/downloads/signed-url

Generate a time-limited signed download URL. Requires valid entitlement (post-purchase).

POST

/disclosures/acknowledge

Record a user's acceptance of a versioned trading disclosure. Required before live/paper download.

POST

/upsell/evaluate

Evaluate upsell rules for a given trigger context. Returns ranked offer list.

POST

/webhooks/stripe

Stripe webhook receiver for payment events. Triggers entitlement creation on success.

GET

/health

Service health check. Returns status and version.

Paginated product index with sort and filter support.

{
  "page": 1,
  "page_size": 20,
  "total": 42,
  "products": [...]
}

Structured risk metadata for high-risk products.

{
  "execution_mode": "live",
  "risk_level": "high",
  "kill_switch": true,
  "disclosure_version": "1.0.0"
}