Soren

Endpoints (47 live)

• GET /v1/chain/balance — Read the native ETH balance of any Base address, live from Base mainnet, for a fraction of a cent. No API key, no account — a wallet is the only requirement, and you are charged only if the read succeeds. Plain unsigned data; the attested version of chain reads is /v1/oracle/onchain. Answers are read at the moment of the call and stamped with the block they came from where applicable. (0.002 USDC on Base)
• GET /v1/chain/receipt — Read whether a transaction SUCCEEDED — a tx can be in a block and still have failed; status is the truth, live from Base mainnet, for a fraction of a cent. No API key, no account — a wallet is the only requirement, and you are charged only if the read succeeds. Plain unsigned data; the attested version of chain reads is /v1/oracle/onchain. Answers are read at the moment of the call and stamped with the block they came from where applicable. (0.003 USDC on Base)
• POST /v1/coord/session — Distributed locks, semaphores, shared rate-limit buckets and monotonic counters for multi- agent fleets. Use it when nine agents share one upstream API quota, or ten workers must not process the same job twice. Buy an operation budget once, then every call runs at ordinary HTTP latency instead of waiting on settlement. Tiers: 100 ops $0.05, 1000 $0.25, 5000 $1.00. Renew and release are always free. Every acquire returns a fencing token: a TTL lock alone is not mutual exclusion. (0.25 USDC on Base)
• GET /v1/chain/erc20-balance — Read an ERC-20 balance with symbol, decimals and a formatted amount — one call, no ABI work, live from Base mainnet, for a fraction of a cent. No API key, no account — a wallet is the only requirement, and you are charged only if the read succeeds. Plain unsigned data; the attested version of chain reads is /v1/oracle/onchain. Answers are read at the moment of the call and stamped with the block they came from where applicable. (0.003 USDC on Base)
• GET /v1/chain/tx — Read a transaction by hash: from, to, value, block, or found:false, live from Base mainnet, for a fraction of a cent. No API key, no account — a wallet is the only requirement, and you are charged only if the read succeeds. Plain unsigned data; the attested version of chain reads is /v1/oracle/onchain. Answers are read at the moment of the call and stamped with the block they came from where applicable. (0.003 USDC on Base)
• GET /v1/chain/nonce — Read the next nonce for an address, live from Base mainnet, for a fraction of a cent. No API key, no account — a wallet is the only requirement, and you are charged only if the read succeeds. Plain unsigned data; the attested version of chain reads is /v1/oracle/onchain. Answers are read at the moment of the call and stamped with the block they came from where applicable. (0.002 USDC on Base)
• GET /v1/chain/gas — Read current gas price and base fee, live from Base mainnet, for a fraction of a cent. No API key, no account — a wallet is the only requirement, and you are charged only if the read succeeds. Plain unsigned data; the attested version of chain reads is /v1/oracle/onchain. Answers are read at the moment of the call and stamped with the block they came from where applicable. (0.002 USDC on Base)
• GET /v1/chain/supply — Read an ERC-20 total supply with symbol, decimals and a formatted amount, live from Base mainnet, for a fraction of a cent. No API key, no account — a wallet is the only requirement, and you are charged only if the read succeeds. Plain unsigned data; the attested version of chain reads is /v1/oracle/onchain. Answers are read at the moment of the call and stamped with the block they came from where applicable. (0.003 USDC on Base)
• GET /v1/roundtrip — The same as paid-ping, plus how long verification and settlement actually took, measured server-side. For choosing your own client timeouts from evidence rather than guessing. Settlement on Base typically completes in one to three seconds, so a timeout under five seconds produces false failures on a healthy network. (0.01 USDC on Base)
• GET /v1/upcoming — Giveaways already announced but not yet claimable, with the exact date each becomes free and what it normally costs. Forward-looking information no training data can contain. Currently Epic Games Store only — no other storefront publishes a schedule. (0.01 USDC on Base)
• POST /v1/ai/summarize — A faithful, information-dense summary of any text up to 24,000 characters, for agents holding a wallet but no LLM key. POST the text as the raw body; length=short (2-4 sentences, default) or medium. Temperature-zero, no invented facts, no preamble — and charged ONLY if the summary is produced. A failed inference costs nothing. (0.03 USDC on Base)
• GET /v1/attestation — A signed, timestamped statement that a specific SHA-256 was presented to Soren at a given moment. Use it when a counterparty must check that your output existed by then. You send only the hash — we never receive your content, so there is nothing to leak or be compelled to produce. An agent signing its own output proves nothing to anyone else. Not a legal notarisation, not proof of authorship, not proof it existed earlier. Verify with soren.com/oracle-key.json (0.02 USDC on Base)
• POST /v1/ai/extract — Named fields pulled out of unstructured text as GUARANTEED-VALID JSON. POST the text as the raw body with fields=comma,separated,names (max 12). Every requested field is present in the answer — null when the text does not contain it — and the JSON is validated server-side BEFORE you are charged: no parse errors, no missing keys, ever. A failed inference costs nothing. (0.03 USDC on Base)
• GET /v1/web/research — A researched answer in ONE paid call: a live web search plus the top 3 results rendered to clean markdown. The single-call route costs four payments and four settlement waits; this is the same work in one payment, seconds faster and cheaper than the parts. Charged only if the search succeeds AND at least one page renders — a failed research costs nothing. Pages cap at 60KB each; unrendered runners-up are listed too. (0.06 USDC on Base)
• GET /v1/web/read — Read any public web page as clean markdown — rendered, boilerplate stripped, ready for a context window. Use it when your agent needs the content of a URL and has a wallet instead of a scraping stack. Charged ONLY if the fetch succeeds; a failed fetch costs nothing. stealth=true ($0.05) gets past aggressive bot protection. Pair with /v1/web/search to find pages first. (0.02 USDC on Base)
• GET /v1/free-games — Every PC game currently free to KEEP (claim once, own permanently) across Steam, Epic Games Store, GOG and itch.io. Each entry verified against that store's own API before publication. Per-store status distinguishes "verified: nothing is free" from "could not check", so a zero is a fact rather than an absence of data. Self-verifying: the version field is a SHA-256 of the payload's own content. (0.02 USDC on Base)
• POST /v1/wake — An alarm clock for agents. Pay one cent, name a moment (30s to 30 days out), and either get a SIGNED wake receipt POSTed to your https callback at that time, with retries, or poll a free status URL that flips when it fires. Stop staying alive and burning compute to wait for a retry window, a confirmation, or an escrow deadline. Callbacks need a consent handshake: your endpoint echoes our challenge or nothing is charged. The Ed25519 receipt binds scheduled and actual fire time. (0.01 USDC on Base)
• POST /v1/ai/judge — A neutral, SIGNED verdict on whether a deliverable meets stated criteria, or which of two candidates is better. Neither party to an A2A transaction can referee it — this is a party with no stake, signing over the SHA-256 of the exact bytes judged. Identical inputs return the identical verdict for 30 days, so verdict-shopping is impossible. Fix criteria first with /v1/commit. Charged only if a verdict is produced. (0.05 USDC on Base)
• GET /v1/chain/block — Read a block header by number or the latest, live from Base mainnet, for a fraction of a cent. No API key, no account — a wallet is the only requirement, and you are charged only if the read succeeds. Plain unsigned data; the attested version of chain reads is /v1/oracle/onchain. Answers are read at the moment of the call and stamped with the block they came from where applicable. (0.002 USDC on Base)
• GET /v1/paid-ping — A heartbeat that costs money, and therefore proves more than a health check: not merely that the server answers, but that x402 verification and settlement are working right now, end to end. Suitable for a monitor that needs to know the PAID path is alive. (0.01 USDC on Base)

+27 more endpoints.