ChainLedgerAI Documentation

What is ChainLedgerAI?

ChainLedgerAI answers "what happened with this address" using Google's public Ethereum dataset — transaction counts, volume, counterparties, and activity windows. An optional AI summary turns those numbers into a couple of plain-English sentences.

Guardrail, built into the API itself: ChainLedgerAI never returns a risk score, compliance flag, or AML/sanctions judgment — only neutral activity metrics. If the AI summary generator ever produces language that violates that rule, the API fails closed and returns an error instead of the summary, rather than passing risk/compliance language through.

Sign Up (Free)

Getting started takes under a minute — no password required:

Step 1: Click "Try Free Tier"

On oculix.io, click "Try Free Tier" or "Get Started" to open the signup form.

Step 2: Enter Your Name and Email

No credit card, no password. Just your name and email.

Step 3: Verify Your Email

We'll send a verification link to your inbox. Click it to activate your account — no password to set.

Step 4: Copy Your API Key

Your key is shown once on the verification page — copy it right away. Use it as the X-API-Key header on every request.

Your First Query

You can also just use the live widget below instead of calling the API directly.

Address Activity Metrics

Query a real Ethereum address for its transaction activity over a lookback window:

curl -X POST https://chainledger-api-885208777871.us-central1.run.app/v1/chainledger/address-metrics \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "lookback_days": 30
  }'
    

Response:

{
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "tx_count_in": 6,
  "tx_count_out": 41,
  "total_value_in_wei": 10128301072721483,
  "total_value_out_wei": 44000000000000000,
  "unique_counterparties": 15,
  "first_seen": "2026-07-13T08:11:59+00:00",
  "last_seen": "2026-07-18T19:16:47+00:00",
  "label": "moderate-frequency"
}
    

AI Summary (optional)

Same request body, different endpoint — /v1/chainledger/summarize — returns a 2-sentence plain-English summary generated from the same metrics, instead of the raw numbers:

{
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "summary": "The activity involved 6 incoming transactions and 41 outgoing transactions. This activity occurred at a moderate frequency."
}
    

Pricing

Plan	Calls/Day	Cost	Best For
Free	1,000	$0	Testing, research
Developer	50,000	$49/month	dApps, analytics tools
Pro	500,000	$199/month	High-volume applications

FAQ

Q: Is this data real-time?

A: It's queried live against Google's public BigQuery Ethereum dataset at request time — as current as that dataset's own update cadence, typically minutes behind chain head.

Q: Can I access PII or personal data?

A: No. ChainLedgerAI provides only public blockchain data (addresses, transactions, balances). It never stores or exposes off-chain personal information.

Q: Does ChainLedgerAI ever return a risk score?

A: No, by design. Every response is limited to neutral activity metrics (counts, volume, an activity-frequency label like "moderate-frequency"). This is enforced at the API level, not just a policy — the summary endpoint fails closed rather than returning risk/compliance language.

Q: How do I monitor usage?

A: Call GET /v1/usage on the auth service with your x-api-key header — it returns your remaining quota plus a call-count breakdown by endpoint. A full self-serve dashboard is still on the roadmap.

Troubleshooting

Q: "Unauthorized" Error

A: Re-copy the key from your original verification email — it's only shown once and there's no Settings page to view it again yet.

Q: 400 "doesn't look like a valid Ethereum address"

A: Addresses must be 0x followed by 40 hex characters. Double-check for typos or truncation.

Next Steps

Batch exports: on the roadmap — not live yet. Every call today queries one address at a time.
Usage tracking: a self-serve usage dashboard is planned but not live yet — contact support if you need your current usage.
Upgrade to Developer or Pro tier when you're ready to scale past the free tier.

Ready to try it? Start with 1,000 free calls/day to test. No credit card. Upgrade when you're ready.

Subscribe: Growth $49/mo → Subscribe: Scale $199/mo →

← Back to Home

🔗 ChainLedgerAI Getting Started