Skip to content

v0.1.0 — Initial release

Latest

Choose a tag to compare

@basedcryptoji basedcryptoji released this 19 May 17:49
· 3 commits to main since this release

AI-native legal data layer for the agentic economy.

500M+ US federal court records · 94 federal courts · 11 data endpoints. Permissionless access via x402 micropayments on Base — $0.001 USDC per query, or hold 1B+ $CLERK for free unlimited.

What's in this release

clerk_api Python client

  • ClerkClient with x402 payment support (tx_hash or pre-encoded payment_header)
  • Demo mode for /search — no payment required
  • 10 endpoint methods: search, docket, parties, judges, citations, opinion, filings, oral_arguments, document, court
  • Typed errors: ClerkError, PaymentRequired
  • httpx + requests fallback

Examples

  • examples/search_cases.py — zero-config demo search
  • examples/party_lookup.py — entity-by-name (paid)
  • examples/judge_history.py — judicial profile (paid)
  • examples/register_delegates.py — batch delegated-signer registration with secure env-var key loading

Docs

  • README.md — quick start + endpoint table + $CLERK token info
  • docs/quickstart.md — 10-minute walkthrough including real web3.py USDC payment snippet
  • ENDPOINTS.md — full API reference matching clerk.solvrlabs.ai/
  • CONTRIBUTING.md — issue + PR + scope + security disclosure
  • CHANGELOG.md — Keep-a-Changelog format

Security

  • All examples load wallet private keys from env vars
  • register_delegates.py enforces this with an early-exit if unset
  • Delegated signer pattern documented end-to-end

Install

```bash
pip install clerk-api
```

Or clone:
```bash
git clone https://github.com/basedcryptoji/clerk.git
cd clerk && pip install -e .[examples]
```

Links