API Changelog

Versioning policy

Additive changes ship in place under /api/v1 with a minor version bump: new optional parameters, new fields on existing objects, new values in a response enum, and brand-new endpoints. Your client keeps sending exactly what it sent and keeps getting everything it got. Parse responses leniently — ignore fields you do not recognize — and these releases are invisible to you.

A change that would require you to send something new to keep working, or that renames, removes or retypes a field you already read, ships as a new base path (/api/v2), with a deprecation window on /api/v1 announced here before anything is switched off. We do not quietly change the meaning of an existing field.

The version is reported as info.version in the OpenAPI specification. It is documentation of what the v1 surface currently offers, not a value you send: there is no version header or parameter, and the base path is the only version selector.

1.14.0 2026-11-02

Additive. Majors and token addresses are unchanged.

• Crypto key aliases: crypto:PUMP and crypto:LINK now work on GET /market-depth, /market-depth/bulk, the push stream and /replay. Each alias points at one on-chain token, added by hand after review. Responses carry a resolved block naming the token, and market_types works, with unsplit_markets listing exchange markets whose spot and perp books cannot be split. Any other unknown key still returns 404.

1.5.0 2026-10-21

One new endpoint. Nothing else changes.

• GET /odds: for a BTC, ETH or SOL perp, the odds that price hits your take profit first, your stop first, or neither within 1h, 4h or 24h, next to a random walk with the same volatility, with the EV per $1,000 notional for a long and a short. Monthly results are public on the track record page.

1.4.1 2026-10-20

A higher Premium quota and a new tier name. No request or response field changes.

• The Enterprise tier is now called Developer. It starts at $99/month with 10,000,000 calls per month and 3x the Premium rate limits. Custom limits are still available. The X-API-Tier header still reports enterprise; X-API-Tier-Display now reports Developer.
• Premium. The monthly quota is 2,000,000 calls (was 100,000). GET /market-depth stays at 60 requests per rolling minute.
• The full per-endpoint table for both tiers is in the API overview.

1.4.0 2026-10-13

More chains, crypto majors on replay, and a chain pin for tokens on two chains. Additive: a request without the new inputs returns what it returned before.

• Chains. Base (base, from 2026-10-03), Ethereum (ethereum, from 2026-10-10) and HyperEVM (hyperevm, from 2026-10-11) join Solana and Robinhood Chain wherever the endpoint covers depth. The Chains section lists what each endpoint accepts.
• GET /replay/:address accepts a crypto major's key (crypto:BTC), and GET /market-depth documents the same key.
• chain on /market-depth and /replay now picks which chain answers when a 0x address is a token on two chains. Without it, the most recently scored chain answers, as before.

1.3.1 2026-10-06

Longer depth history. Additive: existing requests return the same data.

• GET /replay/:address: history is now served for up to 365 days (was 14). Every stored snapshot is kept from 2026-10-03 18:00 UTC for Solana and from 2026-10-01 for Robinhood Chain; earlier history back to late September 2026 is at 15-minute (Solana) or hourly (Robinhood Chain) resolution, as reported by each snapshot's tier. The 365 days is a rolling limit: available history grows by one day each day until it reaches 12 months (around October 2027).

1.3.0 2026-10-04

Grouping and filters for depth history. Additive: existing requests return the same data, with a few new fields.

• GET /replay/:address: new group parameter (market, venue, type, all) and filters types, venues, onchain=true, and their exclude forms exclude_types and exclude_venues. Responses add group, filter, facets (depth per type and per venue, with the keys to filter by), and groups / group_idx when grouped by venue or type.
• markets=split|aggregate still works and is now deprecated: it means group=market or group=all. The response field markets_mode is deprecated the same way.

1.2.0 2026-10-03

New endpoint. Additive, no action required from existing integrations.

• GET /replay/:address: a token's depth history, per market and price bin, at the resolution it is stored, for up to 14 days. Columnar JSON, paged by time with next_from, 1 request per 10 seconds per key (10 requests per second on Enterprise).

1.1.0 2026-09-27

Multi-chain support. Entirely additive — no breaking changes, and no action required from existing integrations.

• Optional chain parameter on every endpoint — a query parameter on GET, a body field on POST /score and POST /whale-activity. Values are the chain keys the endpoint covers, plus all.
• chain field on every token object — scores, token info blocks, DCA orders, limit orders and LP cheat-sheet rows — plus a top-level chain echo on the score, top-scores, dlmm/:address, dlmm-pools and lp-cheat-sheet responses, and inside every query_parameters echo.
• Three new 400 error codes: invalid_chain, chain_not_supported and chain_mismatch. They only ever appear on a request that sends chain, or that sends a 0x address to a Solana-only endpoint. A chain that simply names which chain an address is on is never an error — only one that contradicts the address is.
• One CLOBr score per asset. A token that trades on more than one chain has a single score, computed from depth merged across all of them. /score and /top-scores report that one number, the same one the CLOBr web app shows, whichever of the asset's addresses you ask about.
• GET /score/:address is now documented in the OpenAPI specification. The route itself is unchanged and has been live since 1.0.0.
• /score, /top-scores and /limit-orders now serve Robinhood Chain tokens alongside Solana. Address-keyed endpoints accept a 0x contract address wherever the data exists on that chain.
• List endpoints still default to solana (/top-scores, /dca-pressure, /dlmm-pools, /lp-cheat-sheet). Mixing other chains into a list you already consume would be a breaking change in disguise, so you opt in with chain=all or a specific key.

Details and per-endpoint chain support: Chains in the endpoint reference.

1.0.0

Initial public release of the CLOBr API, Solana only:

• Token scores — GET /score/:address and the Enterprise batch POST /score, plus GET /top-scores.
• Liquidity — GET /market-depth with optional aggregated support/resistance summaries.
• Order flow — GET /dca-pressure, GET /dca-orders and GET /limit-orders.
• Holders — GET /whale-activity and the bulk POST /whale-activity.
• LP tooling — GET /dlmm/:address, GET /dlmm-pools and GET /lp-cheat-sheet.
• API-key authentication via the x-api-key header, with Premium and Enterprise tiers.