# Lucidblock

> Lucidblock Positions: read-only Solana DeFi positions with explicit coverage and sourced USD values.

- [Introduction](https://docs.lucidblock.xyz/index.md): Read-only Solana DeFi positions with explicit coverage and sourced USD values.
- [Quickstart](https://docs.lucidblock.xyz/quickstart.md): From zero to a wallet snapshot, then how to read it.
- [Coverage vs valuation](https://docs.lucidblock.xyz/concepts/coverage-and-valuation.md): Did we look everywhere we support, and could we price what we found?
- [Freshness](https://docs.lucidblock.xyz/concepts/freshness.md): Snapshot age, slots, price age and the stale-while-refreshing rules.
- [Totals](https://docs.lucidblock.xyz/concepts/totals.md): When total_value_usd is null, what known_value_usd means, and how prices feed them.
- [Positions and legs](https://docs.lucidblock.xyz/concepts/positions-and-legs.md): Positions, leg roles, valuation statuses, flags and warnings.
- [Tokens](https://docs.lucidblock.xyz/concepts/tokens.md): Wallet token balances with include=tokens, kept separate from DeFi totals.
- [Integrate with ?wait=8](https://docs.lucidblock.xyz/guides/wait.md): Get the snapshot in one call for most cold wallets, with polling as the fallback.
- [Polling and the 202 flow](https://docs.lucidblock.xyz/guides/polling.md): What to do when a wallet has no fresh snapshot yet.
- [Pagination](https://docs.lucidblock.xyz/guides/pagination.md): Page through positions with limit and cursor.
- [Error handling](https://docs.lucidblock.xyz/guides/error-handling.md): Retries, partial coverage and null values.
- [Supported protocols](https://docs.lucidblock.xyz/reference/supported-protocols.md): Every verified adapter, its categories and its limitations.
- [Errors](https://docs.lucidblock.xyz/reference/errors.md): The error envelope and every error code.
- [Rate limits and access](https://docs.lucidblock.xyz/reference/rate-limits.md): Per-IP limits, headers and access during the alpha.
- [Performance](https://docs.lucidblock.xyz/reference/performance.md): Freshness guarantees, RPC cost and measured latency.
- [Valuation methodology](https://docs.lucidblock.xyz/reference/valuation-methodology.md): Price sources, grades, thresholds and the LST basis.
- [Overview](https://docs.lucidblock.xyz/api-reference/overview.md): Conventions, authentication, errors, caching and CORS.
- [Shared types](https://docs.lucidblock.xyz/api-reference/shared-types.md): Field tables for the objects the endpoints return.
- [Service health](https://docs.lucidblock.xyz/api-reference/meta/service-health.md)
- [HTML API documentation page](https://docs.lucidblock.xyz/api-reference/meta/html-api-documentation-page.md)
- [This contract as JSON](https://docs.lucidblock.xyz/api-reference/meta/this-contract-as-json.md)
- [First-party logo file (14 §3.3). Outside /v1, no access token, own per-IP limit.](https://docs.lucidblock.xyz/api-reference/meta/first-party-logo-file-14-§33-outside-v1-no-access-token-own-per-ip-limit.md)
- [Wallet DeFi positions snapshot (200) or queued scan (202)](https://docs.lucidblock.xyz/api-reference/positions/wallet-defi-positions-snapshot-200-or-queued-scan-202.md)
- [Scan job status](https://docs.lucidblock.xyz/api-reference/positions/scan-job-status.md)
- [Supported protocol registry](https://docs.lucidblock.xyz/api-reference/catalogue/supported-protocol-registry.md)
- [Discovered, unverified programs (never carry balances)](https://docs.lucidblock.xyz/api-reference/catalogue/discovered-unverified-programs-never-carry-balances.md)
- [Discovery detail for one program](https://docs.lucidblock.xyz/api-reference/catalogue/discovery-detail-for-one-program.md)
- [Category coverage and release status](https://docs.lucidblock.xyz/api-reference/catalogue/category-coverage-and-release-status.md)
- [FAQ](https://docs.lucidblock.xyz/help/faq.md): Answers to the common developer questions.
- [Changelog](https://docs.lucidblock.xyz/help/changelog.md): Newest first. Within v1 every change is additive.

## OpenAPI Specs

- [openapi](/openapi.yaml)


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