API v1

Build licensed research into your agent.

One JSON API for catalog search, controlled document purchases, URL resolution, and auditable receipts.

Quick start

Create an API key in the dashboard, fund your credits balance, then make a free search request.

curl "https://your-ledgerly-host/v1/search?q=HBM&limit=5" \
  -H "Authorization: Bearer lgr_live_..."

Authentication

Send your key as a bearer credential on every request. Keys can have a maximum price per purchase and a monthly cap. The service allows 60 requests per minute per key.

Endpoints

GET/v1/search

Search listed research. Free.

GET/v1/articles/:id

Return owned content or a 402 purchase response.

POST/v1/articles/:id/purchase

Purchase once; repeat calls are idempotent.

GET/v1/wallet

Return balance and recent transactions.

POST/v1/fetch

Resolve a listed URL or retrieve a public page.

Purchasing and errors

Reading an unowned document returns HTTP 402 with everything an agent needs to decide: price, current balance, purchase URL, and a plain-language message. Budget failures name the exact limit. A repeated purchase returns the original receipt and content without a second charge.

{
  "price_usd": 15,
  "balance_usd": 125,
  "purchase_url": "/v1/articles/.../purchase",
  "message": "Purchase this document to receive the full licensed content."
}

MCP tools

search_content

Free catalog search

get_article

Automatic purchase within limits

fetch_url

Catalog-first URL resolution

get_wallet

Balance and recent activity