Introduction

Read-only Solana DeFi positions with explicit coverage and sourced USD values.

Private alpha, partial coverage. The API is in private alpha (release_status: "alpha_partial"): a token is required and only some protocols are covered. See Supported protocols.

Read-only Solana DeFi positions with explicit coverage and sourced USD values.

What it does

Give it a Solana wallet address and it returns the wallet’s positions in the protocols it supports, from verified adapters only. Every position is broken into legs with exact amounts read from chain state. A USD value is given only where it can be sourced, and is null otherwise, never a guessed zero.

Your first request

BASE_URL="https://api.lucidblock.xyz"
curl -s -H "Authorization: Bearer $LUCIDBLOCK_TOKEN" \
  "$BASE_URL/v1/solana/wallets/G4VmLamEV6h15gndx7nHn8TTcu7fJkBBNVN3wTugMNtH/defi-positions?protocols=native_stake"

A captured response, filtered to native stake (the first request for a wallet may return 202 with a job to poll; see Quickstart; add ?wait=8 to get the snapshot in one call in most cases):

Captured example

GET /v1/solana/wallets/G4VmLamEV6h15gndx7nHn8TTcu7fJkBBNVN3wTugMNtH/defi-positions?protocols=native_stake → 200 (captured 2026-11-12 from local positions-filtered)

{
  "chain": "solana",
  "network": "mainnet-beta",
  "wallet": "G4VmLamEV6h15gndx7nHn8TTcu7fJkBBNVN3wTugMNtH",
  "snapshot_id": "a19b0669-78d1-4d65-a9f0-60f32c0fbb95",
  "release_status": "alpha_partial",
  "as_of": "2026-11-12T20:33:30Z",
  "observed_slots": {
    "minimum": 468660578,
    "maximum": 468660591
  },
  "snapshot_consistency": "multi_slot",
  "refreshing": false,
  "refresh_job_id": null,
  "freshness": {
    "age_seconds": 6,
    "stale": false,
    "max_age_seconds": 120
  },
  "coverage": {
    "status": "complete_for_supported_protocols",
    "universe": "supported_adapters_only",
    "supported_protocol_count": 1,
    "completed_protocol_count": 1,
    "failed_protocol_count": 0,
    "unsupported_programs_detected": null,
    "protocols": [
      {
        "id": "native_stake",
        "adapter_version": "1.0.0",
        "status": "complete",
        "warnings": [],
        "error_code": null
      }
    ],
    "wallet_token_scan": {
      "spl_token": "complete",
      "token_2022": "complete",
      "token_accounts_found": 1
    },
    "warnings": [
      "program_discovery_not_run"
    ],
    "skipped_protocol_count": 0
  },
  "positions": [
    {
      "id": "solana:native_stake:116vkzEjoTpFEd3x12XL9HbYJ5EpoC4cZ9a1N5A5mUt",
      "protocol": {
        "id": "native_stake",
        "name": "Solana Stake",
        "program_id": "Stake11111111111111111111111111111111111111"
      },
      "position_type": "native_staking",
      "category": "native_staking",
      "position_account": "116vkzEjoTpFEd3x12XL9HbYJ5EpoC4cZ9a1N5A5mUt",
      "owner_role": "withdraw_authority",
      "market": "BULKEEKf9Hjy4nwCthjzheEk4joH23LLXttAHjqEZmB2",
      "assets": [
        {
          "role": "staked",
          "mint": "So11111111111111111111111111111111111111112",
          "symbol": "SOL",
          "amount_raw": "216875911",
          "decimals": 9,
          "amount": "0.216875911",
          "price_usd": "81.5403431471040927",
          "value_usd": "17.684136203280807116",
          "pricing_source": "builtin:raydium-amm-v4",
          "price_as_of": "2026-11-12T20:31:41.000Z",
          "valuation_status": "priced",
          "confidence": "qualified",
          "claimable": null,
          "amount_basis": "exact",
          "informational": false,
          "in_totals": true,
          "market_price_usd": null,
          "protocol_mark_price_usd": null,
          "price_warnings": [],
          "exclusion_reason": null,
          "context": {
            "account": "116vkzEjoTpFEd3x12XL9HbYJ5EpoC4cZ9a1N5A5mUt",
            "as_of_slot": null,
            "status": "deactivating",
            "reward_index": null
          }
        }
      ],
      "debts": [],
      "rewards": [],
      "net_value_usd": "17.684136203280807116",
      "known_value_usd": "17.684136203280807116",
      "valuation": {
        "status": "complete",
        "priced_leg_count": 1,
        "indicative_leg_count": 0,
        "unpriced_leg_count": 0
      },
      "accounting": {
        "counts_toward_totals": true,
        "parent_position_id": null,
        "carried_forward_from_snapshot": null
      },
      "flags": [],
      "evidence": {
        "slot": 468660586,
        "adapter_version": "1.0.0",
        "method": "program_accounts",
        "accounts": [
          "116vkzEjoTpFEd3x12XL9HbYJ5EpoC4cZ9a1N5A5mUt",
          "SysvarC1ock11111111111111111111111111111111",
          "SysvarStakeHistory1111111111111111111111111"
        ],
        "decoder_hash": "8fbf40e8f01970828a97b687ff32048248b48df81c0a3e89f0c1b853e8ef1108"
      },
      "details": {
        "state_tag": 2,
        "status": "deactivating",
        "active_lamports": "0",
        "activating_lamports": "0",
        "deactivating_lamports": "214582445",
        "inactive_lamports": "10586",
        "rent_exempt_reserve": "2282880",
        "breakdown_reserve_lamports": "2282880",
        "delegated_stake": "214582445",
        "activation_epoch": "943",
        "deactivation_epoch": "1084",
        "voter": "BULKEEKf9Hjy4nwCthjzheEk4joH23LLXttAHjqEZmB2",
        "lockup": {
          "unix_timestamp": "0",
          "epoch": "0",
          "custodian": "G4VmLamEV6h15gndx7nHn8TTcu7fJkBBNVN3wTugMNtH"
        },
        "locked": false,
        "withdrawable_now_lamports": "10586",
        "wallet_is_staker": true,
        "staker": "G4VmLamEV6h15gndx7nHn8TTcu7fJkBBNVN3wTugMNtH",
        "withdrawer": "G4VmLamEV6h15gndx7nHn8TTcu7fJkBBNVN3wTugMNtH",
        "activation_method": "agave_exact",
        "clock_epoch": "1084"
      },
      "warnings": []
    },
    {
      "id": "solana:native_stake:AkKezL7CHq8242RtV4i53gGTmZ13EJC87AinsXXWVnNX",
      "protocol": {
        "id": "native_stake",
        "name": "Solana Stake",
        "program_id": "Stake11111111111111111111111111111111111111"
      },
      "position_type": "native_staking",
      "category": "native_staking",
      "position_account": "AkKezL7CHq8242RtV4i53gGTmZ13EJC87AinsXXWVnNX",
      "owner_role": "withdraw_authority",
      "market": "2NxEEbhqqj1Qptq5LXLbDTP5tLa9f7PqkU8zNgxbGU9P",
      "assets": [
        {
          "role": "staked",
          "mint": "So11111111111111111111111111111111111111112",
          "symbol": "SOL",
          "amount_raw": "34072977",
          "decimals": 9,
          "amount": "0.034072977",
          "price_usd": "81.5403431471040927",
          "value_usd": "2.778322236623385367",
          "pricing_source": "builtin:raydium-amm-v4",
          "price_as_of": "2026-11-12T20:31:41.000Z",
          "valuation_status": "priced",
          "confidence": "qualified",
          "claimable": null,
          "amount_basis": "exact",
          "informational": false,
          "in_totals": true,
          "market_price_usd": null,
          "protocol_mark_price_usd": null,
          "price_warnings": [],
          "exclusion_reason": null,
          "context": {
            "account": "AkKezL7CHq8242RtV4i53gGTmZ13EJC87AinsXXWVnNX",
            "as_of_slot": null,
            "status": "active",
            "reward_index": null
          }
        }
      ],
      "debts": [],
      "rewards": [],
      "net_value_usd": "2.778322236623385367",
      "known_value_usd": "2.778322236623385367",
      "valuation": {
        "status": "complete",
        "priced_leg_count": 1,
        "indicative_leg_count": 0,
        "unpriced_leg_count": 0
      },
      "accounting": {
        "counts_toward_totals": true,
        "parent_position_id": null,
        "carried_forward_from_snapshot": null
      },
      "flags": [],
      "evidence": {
        "slot": 468660586,
        "adapter_version": "1.0.0",
        "method": "program_accounts",
        "accounts": [
          "AkKezL7CHq8242RtV4i53gGTmZ13EJC87AinsXXWVnNX",
          "SysvarC1ock11111111111111111111111111111111",
          "SysvarStakeHistory1111111111111111111111111"
        ],
        "decoder_hash": "8fbf40e8f01970828a97b687ff32048248b48df81c0a3e89f0c1b853e8ef1108"
      },
      "details": {
        "state_tag": 2,
        "status": "active",
        "active_lamports": "31535374",
        "activating_lamports": "0",
        "deactivating_lamports": "0",
        "inactive_lamports": "254723",
        "rent_exempt_reserve": "2282880",
        "breakdown_reserve_lamports": "2282880",
        "delegated_stake": "31535374",
        "activation_epoch": "714",
        "deactivation_epoch": "max",
        "voter": "2NxEEbhqqj1Qptq5LXLbDTP5tLa9f7PqkU8zNgxbGU9P",
        "lockup": {
          "unix_timestamp": "0",
          "epoch": "0",
          "custodian": "G4VmLamEV6h15gndx7nHn8TTcu7fJkBBNVN3wTugMNtH"
        },
        "locked": false,
        "withdrawable_now_lamports": "254723",
        "wallet_is_staker": true,
        "staker": "G4VmLamEV6h15gndx7nHn8TTcu7fJkBBNVN3wTugMNtH",
        "withdrawer": "G4VmLamEV6h15gndx7nHn8TTcu7fJkBBNVN3wTugMNtH",
        "activation_method": "agave_exact",
        "clock_epoch": "1084"
      },
      "warnings": []
    }
  ],
  "page": {
    "limit": 100,
    "returned": 2,
    "total_positions": 2,
    "next_cursor": null,
    "page_complete": true
  },
  "totals": {
    "total_value_usd": "20.462458439904192483",
    "known_value_usd": "20.462458439904192483",
    "total_null_reasons": [],
    "unpriced_position_count": 0,
    "priced_leg_count": 2,
    "indicative_leg_count": 0,
    "unpriced_leg_count": 0,
    "excluded": {
      "indicative_value_usd": null,
      "stale_value_usd": null,
      "estimated_rewards_value_usd": null,
      "claimable_rewards_not_included_usd": null,
      "staker_only_value_usd": null
    },
    "valuation_status": "complete",
    "include_rewards_in_total": false,
    "price_sources": [],
    "note": "Value includes only the explicitly supported scanned DeFi universe; it is not universal wallet net worth."
  },
  "request": {
    "include": [
      "underlying",
      "rewards",
      "valuation"
    ],
    "protocols": [
      "native_stake"
    ],
    "freshness_seconds": 120,
    "include_rewards_in_total": false,
    "limit": 100
  }
}

Why it’s different

• Explicit coverage. Every snapshot lists each supported protocol as complete, partial, error, not_applicable or skipped. The absence of a position means something only for complete protocols.
• Null, not zero. Unknown values are null. total_value_usd is null unless coverage is complete and every counted leg is priced, and total_null_reasons says why.
• Per-leg provenance. Each leg names its pricing_source, price_as_of and valuation_status.
• No double counting. LSTs, LP receipts and nested vaults are counted once.
• Read-only. No wallet connection, no signature, no transaction.

Key features

• 26 verified adapters across lending, concentrated, bin and fungible liquidity, vaults, native and liquid staking, perpetuals and rewards: see Supported protocols.
• Built-in on-chain prices, refreshed every 2 minutes; LSTs valued by redemption rate.
• Async scans: 202 + job polling for cold wallets, or one call with ?wait=8; stale snapshots (at most 10 minutes old) served at once while a refresh runs.
• Optional wallet token balances with include=tokens, kept separate from the DeFi totals.

Honest limits

• Supported universe only: not wallet net worth. Protocols outside the supported list are not seen at all.
• Alpha and partial: release_status is alpha_partial.
• Snapshots are not atomic (snapshot_consistency: multi_slot).
• No history: each snapshot is the current state.
• Not an oracle: prices are not executable quotes.
• Orca Whirlpools is pending licence clearance; Drift is not supported; Pyth is not used.

Where to go next

Quickstart

Your first wallet snapshot, and how to read it.

Concepts

Coverage, null-not-zero, totals and freshness.

Supported protocols

Every verified adapter and its limitations.

API reference

Conventions, and every endpoint from the OpenAPI contract.

Errors

The error envelope and every code.

FAQ

Answers to the common developer questions.