Reference

The API

SPXI-gnΩsis 0.23.0, protocol EA-WIKI-OPEN-01 v1.1 (#1697). The same description is served as JSON at GET / with Accept: application/json, and as text at /llms.txt. Agents connect over MCP at POST /mcp (listed as dev.spxi/gnosis); payment is taken at the HTTP routes.

Operations

POST /v1/quote: free. body {oldid (or article: a Wikipedia link or title, pinned to its current revision), tier?: check|ledger|opening|commission|portable, claims?: [ids]} or, for an object (an entity, whether or not the encyclopedia holds it, or an operator), {commission?: open|construct, object: {kind?: entity|operator, name, aliases? (entity), strings? (operator: the phrases in which it is performed and in which entities speak it), description?, works_by?, capture?: obs_id|slug, transcript?: {text, surface, date, cite_list} (open: admitted through discernment), sources?: [url], compare?: encyclopedia (construct)}, tier?: commission|portable}; the legacy {entity: {...}} form is accepted; or {random: open|construct, tier?, pool?: wikipedia|archive}: the service picks a random Wikipedia article and one sentence in it that cites a source (open, read at tier check or opening), or, for construct, a random Wikipedia article, constructed as an alternative to it from the sources it cites, or an entity the archive names with no /non entry (pool chosen at random unless named), and the quote carries the pick as random. A revision is opened; an object is opened where a composition is found or supplied, and constructed otherwise. Pins the revision and resolves its sources; an opening prices each sentence in cents and never consults the archive; at the commission and portable tiers the archive traversal runs and is priced; returns scope, cost-based prices, the execution contract and the maximum price.
GET /v1/results/{result_id}/portable/{file}: portable tier: the entity's knowledge object from its /non row (article.md, article.html, article.jsonld, article.json, manifest.json, LICENSE.txt; CC BY 4.0, with the Wikipedia article's quoted sentences CC BY-SA 4.0)
POST /v1/openings/{quote_id}: paid by agents (x402, USDC on Base, settling to the service's Stripe balance; answers 503 until a receiving address is set). Pays for a quote and starts its work; answers 202 with the status address, where the result id appears on delivery (an order that consults the archive is run by the archive worker). A quote already paid answers with its result, or where it stands, without a second charge; what the work did not use is refunded.
GET /v1/sentence?text=&url=&mode=: the sentence as you have it and the Wikipedia page it came from: free where it has been read (as recorded); otherwise 402 with the price, then the opening (two readings); mode=preliminary, one quick pass; mode=grounded, the opening with the archive's claims on the sentence from a commissioned /non row (two cents more; where no row holds the sentence, the commission is offered and nothing is charged)
POST /v1/openings/{quote_id}/checkout: for people: a Stripe Checkout link for the quote's maximum (at least $0.50); the work runs when the payment completes, and what it did not use is refunded
GET /v1/quotes/{quote_id}/status: where a quote stands: quoted, paid and running, delivered; its receipt and any refund
GET /v1/results/{result_id}/publication: the /non row's publication, observed now: composed, checked, landed, public
archive worker: commissions, portable packages and entity objects consult the archive, which this deployment does not hold: their quotes and runs are made by a scheduled job with the archive checked out (https://github.com/leesharks000/spxignosis/actions/workflows/archive-worker.yml); a quote answers 202 with its status address, and a paid order is queued, run there and settled here
POST /v1/quotes/{quote_id}/resume: a paid card order whose run stopped (no progress for six minutes, nothing delivered or refunded) is started again
GET /v1/results/{result_id}/landing: the /non row's landing tree: the manifest, each file at …/landing/{path}, for the operator's landing
GET /v1/openings/{quote_id}/progress: the stage a running opening has reached
GET /v1/non?name=&context=: free: the /non entry a name answers, or the candidates and what tells them apart, or the construction offered as a free quote
POST /mcp: the same requests as tools for agents (Model Context Protocol, Streamable HTTP, JSON): find_entry, open_sentence, get_quote, order_status, card_checkout, get_result; payment is taken at the HTTP routes the tools name
GET /v1/calibration: the latest calibration release of the reading passes: the procedure run live on held-out /non rows and scored against each row by stage (admission, archive claims, field claims, case, ρ), with its cost
GET /v1/receipts/{quote_id}: the settlement receipt (transaction, payer, amount) and any refund owed or sent
GET /v1/results/{result_id}/composition: the usable result
GET /v1/results/{result_id}/evidence: the full evidence record: tuples, spans, hashes, validations, breaches, cost
GET /v1/results/{result_id}/opened.html: the opened article
GET /v1/results/{result_id}/annotations: W3C Web Annotations on the pinned revision

This deployment

card: live (Stripe Checkout)
agents: x402 on eip155:8453 (USDC; facilitator https://facilitator.payai.network)
reader: live: the model key is set
archive worker: on request
landing: on delivery of a paid row (leesharks000/alexanarch, land-non-rows.yml)
storage: private Vercel Blob, with this instance's /tmp in front

Publication

Every commission composes the entity's row in the Negative of the Negative (alexanarch.org/non), the opened Wikipedia, and the row is public (CC BY 4.0): a paid commission contributes to the public counter-infrastructure it draws on.

The treatment of an article's entities by composing systems may be recorded and measured.