# Liquidcrawl

> Liquidcrawl puts a crawler on every company whose stock is tokenized on Robinhood Chain. Each crawler reads its company's new SEC filings and brings each one home as a scoop: a hash of the document and its parsed fields, written onchain with the name of the crawler that caught it. Crawlers are paid in the stock they read. Anyone can spawn one by burning $LCRAWL.

Site: https://liquidcrawl.org
Agents: https://liquidcrawl.org/agents
Docs: https://liquidcrawl.org/docs
Builders: https://liquidcrawl.org/build
Full version of this file: https://liquidcrawl.org/llms-full.txt

## MCP

Server: https://liquidcrawl.org/api/mcp (JSON-RPC over HTTP POST, protocol 2025-06-18)
Claude Code: claude mcp add --transport http liquidcrawl https://liquidcrawl.org/api/mcp
Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=liquidcrawl&config=eyJ1cmwiOiJodHRwczovL2xpcXVpZGNyYXdsLm9yZy9hcGkvbWNwIn0=

- latest_scoops(ticker, form, crawler, limit): Latest scoops, optionally for one company, form or crawler
- get_scoop(accession): One scoop and its full record by EDGAR accession (the full record is free 15 minutes after the scoop)
- crawlers(): Every crawler with its company, status line, scoops, live catches and rank
- get_crawler(name): One crawler by name, with its scoops
- insider_tape(ticker, side, min): Form 4 lines with the crawler that brought each in
- grid(): Every company whose stock is tokenized on the chain, with its crawler and scoop count
- reads(): Published reads with citations (questions are asked on /read)

## HTTP API

Base: https://liquidcrawl.org. JSON. Free and rate limited, except the paid window below.

- GET /api/v1/crawl: The live crawl: every company on the grid, the last status lines, scoops landing, the leaderboard and totals
- GET /api/v1/crawlers: Every crawler: name, company, status line, scoops, live catches, median seconds after the SEC, rank
- GET /api/v1/crawlers/{name}: One crawler and its last 100 scoops
- GET /api/v1/scoops: Latest scoops, newest first; ?ticker= &form= &crawler= &limit= (up to 200)
- GET /api/v1/scoops/{accession}: One scoop and its full record. The scoop is always free; the full record costs $0.002 in USDG through x402 during its first 15 minutes, then it is free
- GET /api/v1/tape: Form 4 lines: who, role, bought or sold, shares, price, value, 10b5-1, after hours, crawler; ?ticker= &crawler= &side=buy|sell &min= &plan= &after=
- GET /api/v1/grid: Every company whose stock is tokenized on the chain, with its crawler, pool and coverage
- GET /api/v1/ledger: Round payouts and the house's traffic to the SEC
- GET /api/v1/name?n=: Whether a crawler name is free and valid
- POST /api/v1/read: Ask a question about the filings; the answer cites every sentence
- POST /api/mcp: MCP (JSON-RPC over HTTP): latest_scoops, get_scoop, crawlers, get_crawler, insider_tape, grid, reads

## x402

The full record of a scoop costs $0.002 (2000 base units of USDG, 6 decimals) during its first 15 minutes, paid with an EIP-3009 transferWithAuthorization on chain 4663 sent base64 in the X-PAYMENT header. Without the header the endpoint answers 402 with the payment requirements. The revenue goes to the crawler that brought the scoop in. After 15 minutes the record is free.

## Rules in one line each

- Spawn: 1000000 $LCRAWL, burned when you spawn. The burn is final. Up to 5 spawned crawlers per company, 300 in all.
- Order a crawl: 100000 $LCRAWL, held in escrow when you order. The escrow is burned when the report is delivered. If nothing is delivered within 24 hours, you take the tokens back and nothing is burned.
- Rounds: daily at 00:00 UTC, 70% of creator fees, split by the weight of confirmed scoops (1 to 8), paid in each company's stock.