Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 1 addition & 44 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -445,48 +445,6 @@ LLM agents discover all eight operations as `blockrun_phone_*` / `blockrun_voice

---

## Crypto Data (Surf)

Surf is BlockRun's unified crypto data API — **84 endpoints across 13 domains**: CEX/DEX markets, on-chain SQL over 80+ ClickHouse tables (Ethereum, Base, Arbitrum, BSC, TRON, HyperEVM, Tempo), 100M+ labeled wallets, prediction markets (Polymarket + Kalshi), social/CT mindshare, news, project/DeFi metrics, token analytics, unified search, VC fund intelligence. The killer feature is ad-hoc `POST /surf/onchain/sql` — agents query the warehouse directly without running an indexer.

ClawRouter ships Surf as a **skill, not as typed wrappers**. The proxy whitelists `/v1/surf/*` so any call through the local proxy is paid x402 from the same wallet; the agent reads `skills/surf/SKILL.md` for the endpoint catalog and crafts the HTTP call. No `blockrun_surf_*` tool definitions to maintain; a new Surf endpoint requires zero ClawRouter release.

**Flat per-call pricing** — every Surf endpoint costs the same. The old
$0.001/$0.005/$0.020 tiers no longer apply; upstream prices all three tiers
identically, and the tier now describes only endpoint weight.

| Rail | Price per call |
| --------------------------- | ---------------------------------- |
| API key (`api.blockrun.ai`) | **$0.0075** (base rate, no tx fee) |
| Wallet — Solana | **$0.0075** |
| Wallet — Base | **$0.0085** |

Measured 2026-09-05: the API-key rate from the account ledger, the wallet rates
from the x402 challenge, which quotes the price before anything is signed. That
quote is authoritative for the rail that issued it — the key rail issues no 402,
and the wallet quote includes a transaction fee account credit does not pay, so
the two are not interchangeable. Solana being cheaper than Base is deliberate
(the $0.001 is Base's transaction fee), not drift.

**Usage (HTTP):**

```bash
# Aggregated BTC spot price (Tier 1, $0.001)
curl 'http://localhost:8402/v1/surf/market/price?symbol=BTC'

# Bulk wallet labels over 100M+ labeled wallets (Tier 2, $0.005)
curl 'http://localhost:8402/v1/surf/wallet/labels/batch?addresses=0xabc,0xdef,0x123'

# Ad-hoc on-chain SQL (Tier 3, $0.020)
curl -X POST 'http://localhost:8402/v1/surf/onchain/sql' \
-H 'content-type: application/json' \
-d '{"sql":"SELECT count() FROM ethereum.transactions WHERE block_timestamp >= now() - INTERVAL 1 HOUR"}'
```

No Surf account, no API key — settles directly to Surf's Base treasury in USDC via the same wallet as LLM calls. Full endpoint reference: [`skills/surf/SKILL.md`](skills/surf/SKILL.md). Upstream marketplace: <https://blockrun.ai/marketplace/surf>.

---

## Models & Pricing

<!-- br:models.chatVisible -->90<!-- /br:models.chatVisible --> models across 9 providers, one wallet. **<!-- br:models.free -->7<!-- /br:models.free --> models are $0 — paid models start at fractions of a cent.**
Expand Down Expand Up @@ -740,8 +698,7 @@ chains, the response cache and the local spend controls.
- **One key covers nearly everything.** Verified live against `api.blockrun.ai`
on 2026-09-05: chat completions (`/v1/chat/completions`), the Anthropic-shaped
`/v1/messages`, `/v1/models`, image generation, speech, video, and the partner
APIs — Surf crypto data, Exa search, prediction markets, and phone lookup and
fraud checks.
APIs — Exa search, prediction markets, and phone lookup and fraud checks.
- **The wallet-only exceptions** are the routes that bind a lease or a position
to a payer address, because there is no address to bind to without a wallet:
buying, renewing, listing and releasing **phone numbers** (the gateway answers
Expand Down
2 changes: 1 addition & 1 deletion openclaw.plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"id": "blockrun-clawrouter",
"name": "BlockRun ClawRouter",
"description": "Smart LLM router \u2014 82 models, x402 micropayments, 84% cost savings. Phone lookup + AI voice calls (Twilio + Bland.ai). Surf crypto-data API (84 endpoints, on-chain SQL, 100M+ labeled wallets) via skill.",
"description": "Smart LLM router \u2014 x402 micropayments, 84% cost savings. Phone lookup + AI voice calls (Twilio + Bland.ai).",
"skills": ["./skills"],
"activation": {
"onStartup": true
Expand Down
17 changes: 0 additions & 17 deletions skills/clawrouter/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,13 +21,6 @@ triggers:
- "phone number verification"
- "sim swap detection"
- "outbound ai call"
- "blockrun surf"
- "surf crypto api"
- "on-chain sql query"
- "clickhouse onchain"
- "wallet labels api"
- "crypto mindshare"
- "crypto news api"
homepage: https://blockrun.ai/clawrouter.md
repository: https://github.com/BlockRunAI/ClawRouter
license: MIT
Expand Down Expand Up @@ -265,16 +258,6 @@ egress by default, so it works out of the box in geoblocked regions).
`blockrun_predexon_*` data tools first. See the **`polymarket-trading` skill**
for the golden rules and end-to-end flow.

### Crypto Data (Surf) — skill-only integration

Surf is a unified crypto data API with **84 endpoints across 13 domains**: CEX/DEX markets, on-chain SQL over 80+ ClickHouse tables (Ethereum, Base, Arbitrum, BSC, TRON, HyperEVM, Tempo), 100M+ labeled wallets, prediction markets (Polymarket + Kalshi), social/CT mindshare, news, project/DeFi metrics, token analytics, unified search, VC fund intelligence. The killer feature is `POST /surf/onchain/sql` — ad-hoc SELECT against the warehouse, no indexer required.

**ClawRouter ships Surf as a skill, not as typed wrappers.** The base proxy whitelists `/v1/surf/*` so any call through `http://127.0.0.1:8402/v1/surf/...` flows through the same x402 wallet that pays for LLM calls. The endpoint catalog, parameter shapes, and example flows live in the dedicated **`surf` skill** — Claude Code (or any agent) reads that skill on demand and crafts the HTTP call itself. No `blockrun_surf_*` tool definitions to maintain, no release of ClawRouter when Surf adds endpoint #85.

Pricing tiers (per call, settled in USDC directly to Surf's Base treasury): **$0.001** prices/rankings/lists/news · **$0.005** orderbooks/candles/search/wallet details/social · **$0.02** on-chain SQL/query/schema, chat completions. No monthly minimums, no Surf account, no API key. See the `surf` skill for the full endpoint reference.

This is the pattern for new BlockRun-marketplace APIs going forward: base proxy whitelists the namespace, a dedicated skill documents the surface — no hand-coded tool wrappers per endpoint.

## Example Output

```
Expand Down
Loading
Loading