> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lucidblock.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Newest first. Within v1 every change is additive.

```bash theme={null}
BASE_URL="https://api.lucidblock.xyz"
```

Newest first. Within v1 every change is additive: new optional fields and new open-enum values only; closed enums and
existing fields never change meaning.

## Unreleased

* `?wait=N` long-poll on the positions endpoint (D-29, 0 to 10 s, default 0): a cold or stale request waits for its
  scan and returns the fresh `200` if it finishes in time, else the usual response. See
  [Quickstart](https://docs.lucidblock.xyz/quickstart.md#your-first-request-in-60-seconds).
* SOL anchor (D-28): with one qualifying on-chain anchor pool, a qualified TokenPrices SOL/USD quote within 50 bps
  confirms it, so SOL stays `priced` at the on-chain price; `pricing_source` gains `+anchor_confirmed_by:tokenprices`.
  See [Valuation methodology](https://docs.lucidblock.xyz/reference/valuation-methodology.md).
* Wallet token balances with `include=tokens` (D-27): native SOL plus every non-zero SPL / Token-2022 mint, with
  metadata, prices, `verified` / `spam_suspected`, `counted_in_position`, and a separate `tokens_total` that never
  mixes with the DeFi `totals`. Not in the default `include`. See [WalletTokens](https://docs.lucidblock.xyz/concepts/tokens.md#wallettokens).
* Pagination (`limit`, `cursor`, `page`) on the positions endpoint (T-A43); `coverage.skipped_protocol_count` and an
  always-present `error_code` / `warnings` per protocol (T-A44).
* Lending: `kamino_lend` (Kamino Lend obligations: supplied and borrowed legs; interest as of each reserve's last
  refresh). Landed ahead of the M2 release.
* Liquidity: `raydium_clmm` (concentrated positions with fee and reward legs, `out_of_range`), `raydium_cpmm` and
  `raydium_amm_v4` (fungible LP tokens). Landed ahead of the M2 release.
* The first production deploy with the hosted viewer (M2).

## v0.1.0 — 2026-11-12 (M1)

### Coverage

* Native staking: `native_stake` (withdraw and stake authority roles; staker-only stake shown but excluded).
* Liquid staking: `spl_stake_pool` (SPL Stake Pool, Sanctum single- and multi-validator pools; verified LST registry).
* Perpetuals: `jupiter_perps` (value = equity; notional as a detail).

### Valuation

* Built-in on-chain prices, refreshed every 2 minutes; graded `priced` / `indicative`; `stale` after 300 s.
* LSTs valued by redemption rate × SOL/USD (D-08).

### Endpoints

* `GET /v1/health`, `GET /v1/solana/wallets/{wallet}/defi-positions` (200 or 202),
  `GET /v1/solana/wallets/{wallet}/defi-positions/jobs/{jobId}`, `GET /v1/solana/protocols`, `GET /v1/solana/coverage`,
  `GET /openapi.json`, `GET /`.

### Behaviour changes

* First release (alpha): coverage and valuation axes, null-not-zero totals with `total_null_reasons`, 202 + job polling
  for cold wallets, stale snapshots served with `refreshing`.

### Known limitations

* Private alpha (token required), local and staging only until the M2 production deploy.
* No liquidity, vault or reward adapters yet; Orca pending licence; Drift not supported.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.