← Liquid State
For AI agents and the people who build them

Crypto market data your AI agent can find, read, and pay for.

A program can find our data, see the price, pay for one request at a time, and get an answer, with no account. There is also a free connector for AI assistants, a free data feed, and an older paper-trading record with stated limits. Information, not financial advice.

Example: an agent pays for one request
$ curl https://www.liquidstate.tech/api/x402/farside-btc-etf
← HTTP/1.1 402 Payment Required   PAYMENT-REQUIRED
  accepts[0]: { scheme: "exact", network: "eip155:8453", amount: "10000" }

$ curl -H "PAYMENT-SIGNATURE: <signed-usdc-authorization>" …/api/x402/farside-btc-etf
← HTTP/1.1 200 OK   PAYMENT-RESPONSE: <settle proof>
  { "leg_id": "…", "receipt_hash": "…" }

Where to look: /.well-known/x402 · /desk-tape-agents.md · /.well-known/agent-offer.json · /openapi.json · /api/mcp

Step by step

Find it, pay, keep the ID, check back, confirm.

  1. Discover /.well-known/x402. It lists what can be bought. The Feed and the three exclusive reads use x402 version 2 on eip155:8453, and carry extensions.bazaar so catalogs can list them.
  2. Ask for the data without paying. The 402 reply carries PAYMENT-REQUIRED, which states the price. Ask again with PAYMENT-SIGNATURE. PAYMENT-RESPONSE is the proof that the payment settled.
  3. Keep the leg_id from the paid answer, called a Decision Leg. It is the ID you quote later.
  4. Check back at GET /api/agents/invalidations?since= to learn if an answer was revised or withdrawn.
  5. Confirm your receipt. Match receipt_hash at GET /api/agents/receipts?leg_id=.
  6. Reserve members can read the full book at GET /api/agents/desk-book. Reserve is $149. Feed $25 does not open it.

The check-back, receipt, and book endpoints are not listed in the catalog. People join at /pricing. Notes for builders: /desk-tape-agents.md.

How it is built

Made so a program can use it without a person.

Each thing an agent can use here is listed in a file it can read. Paid requests show their price before any payment, and a program can pay them on its own. The paid reads need no account and no sales call.

Questions and answers

Can an AI agent pay for Liquid State data autonomously?
Yes. Selected premium reads use x402 (HTTP 402) on Base mainnet (eip155:8453): the endpoint returns a 402 quoting the exact price in USDC, and the agent retries with a PAYMENT-SIGNATURE header. A settled response sets PAYMENT-RESPONSE. No account, no API key, no human in the loop.
How does an agent discover what Liquid State offers?
Three machine-readable entry points: /.well-known/x402 lists the payable resource catalog, /llms.txt maps the platform for language models, and /openapi.json describes every public endpoint in OpenAPI 3.1. A first-party MCP server at /api/mcp exposes the read tools directly.
How does an agent follow a Decision Leg?
Discover /.well-known/x402, pay the exclusive, cite leg_id, poll GET /api/agents/invalidations?since=, verify receipt_hash at GET /api/agents/receipts?leg_id=, and read the Reserve book at GET /api/agents/desk-book. Invalidations, receipts, and the book are not catalog rows. Humans join at /pricing. Feed is $25. Reserve is $149.
Is there a free tier for developers and bots?
Yes. The public Signal API returns aggregated market-regime signals as JSON with no API key, rate-limited only as a soft abuse deterrent. It is free for non-commercial use; attribution is appreciated but not enforced.
What if an agent or product needs more than the free tier?
Join The Feed — $25 or The Reserve — $149. x402 pay-per-call, the free Signal API, and MCP stay available — they are not a third membership SKU.
Is any of this financial advice?
No. Everything Liquid State publishes is information, not financial advice. There are no guaranteed-return claims and no fabricated figures; a compliance gate rejects prescriptive buy/sell calls before publication.

Information, not financial advice. Not a recommendation to trade.