What the agent may display
Licence delivered with the content
Act as an AI agent
Ask a question, set what you will pay and how you will use the content. Publishers' offers come back ranked by relevance; your max price is an all-in ceiling that excludes dearer offers. Among offers nearly as relevant as the best, the cheapest is selected. Accept one to receive a signed entitlement, retrieve the content with it, then report how you used it.
- 1Query
- 2Entitlement
- 3Retrieve
- 4Telemetry
Query the exchange
POST /v1/queryRouting
The exchange keeps a thin profile of each source (declared topics plus sampled titles and abstracts, no full text), asks only the best-matching few, with one slot kept for new or under-served sources, and stops waiting when the time budget runs out.
| Source | Why | Route score | Answer | Candidates |
|---|
No offers this time. The note above explains why and what would change it.
Signed entitlement
POST /v1/offers/{id}/acceptAccept an offer to receive an entitlement: a signed token (EdDSA JWS) that grants this agent one piece of content, at one usage tier, until it expires.
Token
Decoded claims
Licence scope cx
Header
Retrieve the gated content
GET /v1/content/{id}Accept an offer, then retrieve: content is served against the entitlement. Retrieval records the clearing entry and emits the first telemetry event.
Report usage telemetry
POST /v1/telemetryAfter retrieval the agent reports what it did with the content, as a SPUR Content Telemetry v1.0 event batch authorised by the entitlement.
Operator view
Clearing ledger, telemetry stream and supply. The ledger is a record of paid retrievals; no money moves in the MVP.
Totals per publisher
| Publisher | Retrievals | Gross | Clearing fee | Publisher net | Share of gross |
|---|
Ledger entries
GET /v1/admin/ledger| Recorded | Publisher | Content | Usage | Agent | Gross | Fee | Net | Entitlement |
|---|
Telemetry events
GET /v1/admin/telemetry| Received | Stage | Reported by | Content | Detail | Entitlement |
|---|
Agent keys
/v1/admin/agentsLeave the budget empty for unlimited. The key is shown once, here; the exchange keeps only its hash.
| Agent | Label | Key | Budget | Spent | Remaining | Rate / min | Signing | Status |
|---|
Supply adapters
GET /v1/supplyPublishers
Each publisher sets a rate card: a price per retrieval for each usage tier, licence terms, and rules that adjust price by section, tag or age. Publishers receive their price in full; the clearing fee is added on top for the buyer.