API Reference

LedgerBranch API v1

Authentication via bearer API keys with least-privilege scopes. Never request unrestricted access by default.

Search API

GET /api/v1/search?q=

Resolve websites, companies, tokens, wallets, protocols, and APIs.

Pricing: Free tier + usage

Auth: API key · scope DISCOVERY or CREDIT

curl -H "Authorization: Bearer lb_..." "https://ledgerbranch.com/api/v1/search?q=coinbase.com"

{ "query": "coinbase.com", "results": [{ "slug": "coinbase", "credit": "A+" }] }

Credit API

GET /api/v1/credit/{entity}

Evidence-based LedgerBranch Credit with component scores.

Pricing: Free metadata · Paid full intelligence

Auth: API key · scope CREDIT

curl -H "Authorization: Bearer lb_..." https://ledgerbranch.com/api/v1/credit/coinbase

{ "entity": "coinbase", "credit": "A+", "risk": "moderate", "evidence_score": 90, "identity_score": 96, "liquidity_score": 94, "transparency_score": 88, "claim_alignment": 82, "confidence": 0.91 }

Risk API

GET /api/v1/risk/{entity}

Risk profile, elevating and mitigating factors.

Pricing: Usage-based

Auth: API key · scope CREDIT

GET /api/v1/risk/usdc

{ "entity": "usdc", "level": "moderate", "factors": [] }

Entity API

GET /api/v1/entities/{id}

Normalized entity graph with identifiers and evidence.

Pricing: Usage-based

Auth: API key · scope DISCOVERY

GET /api/v1/entities/bitcoin

{ "id": "ent_bitcoin", "type": "token", "identifiers": { "symbols": ["BTC"] } }

Market API

GET /api/v1/markets

Product discovery, quotes, and candles via provider abstraction.

Pricing: Free + volume

Auth: API key · scope READ_MARKETS

GET /api/v1/markets/products

{ "products": [{ "id": "BTC-USD", "status": "read_only" }] }

Onchain API

GET /api/v1/onchain

Onchain activity summaries for contracts and wallets.

Pricing: Usage-based

Auth: API key · scope DISCOVERY

GET /api/v1/onchain?address=0x...

{ "status": "configuration_required" }

Discovery API

GET /api/v1/discovery?q=

Evidence-first ranking across the financial internet.

Pricing: Usage-based

Auth: API key · scope DISCOVERY

GET /api/v1/discovery?q=stablecoin

{ "results": [{ "slug": "usdc", "rank": 1 }] }

Exposure API

POST /api/v1/exposure

Hypothetical loss scenarios for a given exposure amount.

Pricing: Usage-based

Auth: API key · scope ANALYTICS

{ "initialExposure": 10000 }

{ "scenarios": [{ "drawdownPct": 50, "remaining": 5000 }] }

Verification API

GET /api/v1/verification

Verification event hooks and website trust summaries.

Pricing: Usage-based

Auth: API key · scope CREDIT

GET /api/v1/verification?domain=coinbase.com

{ "assessment": "Established business", "risk": "moderate" }

x402 API

GET /api/v1/x402

Programmatic micropayments for premium intelligence endpoints.

Pricing: Pay-per-request

Auth: x402 payment + API key

GET /api/v1/credit/coinbase?tier=institutional

{ "status": "configuration_required", "payment": "x402" }