🔗 ChainLedgerAI Getting Started
Neutral, read-only on-chain data for Ethereum. Query address activity and get AI-assisted summaries — metrics only, never a risk score or compliance judgment.
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: Sign Up
Get your free API key in 30 seconds. No credit card required.
Free API keys are valid for 14 days, and each free account can create one free replacement key. Paid plans’ keys do not expire.
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://api.chainledgerai.io/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 |
Free API keys are valid for 14 days, and each free account can create one free replacement key. Paid plans’ keys do not expire.
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: Your API key is shown once, on your dashboard right after you verify your email, and we can’t display it again. If it’s lost, enter your email in the sign-up form on this page and we’ll email a one-time sign-in link to create a replacement. Otherwise check for extra spaces; API keys are case-sensitive.
Q: My Key Stopped Working: “API key expired”
A: Free API keys are valid for 14 days from the day they are issued, and calls with an expired key return 401 “API key expired”. We email a reminder during the key’s first week (you can unsubscribe from reminders). To keep going, enter your email in the sign-up form on this page to create your one free replacement key. After that replacement expires, upgrade to a paid plan to keep using ChainLedgerAI. Paid plans’ keys do not expire.
Q: How Do I Update My API Key?
A: Enter your email in the sign-up form on this page. We email a one-time sign-in link (valid for 30 minutes) that lets you create a new key. The new key replaces the old one immediately, so update every app that uses it. Free accounts can create one free replacement key; once it is used, upgrade to a paid plan to keep going. Paid plans can replace their key at any time.
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.
- OpenAPI spec: /docs/chainledger/openapi.json (OpenAPI 3.0, for client generators and API tools).
- 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.