Wallet DeFi positions snapshot (200) or queued scan (202)

GET /v1/solana/wallets/{wallet}/defi-positions

Wallet DeFi positions snapshot (200) or queued scan (202)

cURL

curl --request GET \
  --url https://api.lucidblock.xyz/v1/solana/wallets/{wallet}/defi-positions \
  --header 'Authorization: Bearer <token>'

200

{
  "chain": "solana",
  "network": "mainnet-beta",
  "wallet": "<string>",
  "snapshot_id": "<string>",
  "release_status": "alpha_partial",
  "as_of": "<string>",
  "observed_slots": {
    "minimum": 123,
    "maximum": 123
  },
  "snapshot_consistency": "single_slot",
  "refreshing": true,
  "refresh_job_id": "<string>",
  "freshness": {
    "age_seconds": 123,
    "stale": true,
    "max_age_seconds": 123
  },
  "coverage": {
    "status": "complete_for_supported_protocols",
    "universe": "supported_adapters_only",
    "supported_protocol_count": 123,
    "completed_protocol_count": 123,
    "failed_protocol_count": 123,
    "skipped_protocol_count": 123,
    "unsupported_programs_detected": 123,
    "protocols": [
      {
        "id": "<string>",
        "status": "complete",
        "adapter_version": "<string>",
        "warnings": [
          "<string>"
        ],
        "error_code": "<string>"
      }
    ],
    "warnings": [
      "<string>"
    ],
    "last_scan_status": "complete_for_supported_protocols",
    "wallet_token_scan": {
      "spl_token": "complete",
      "token_2022": "complete",
      "token_accounts_found": 123
    }
  },
  "positions": [
    {
      "id": "<string>",
      "protocol": {
        "id": "<string>",
        "name": "<string>",
        "program_id": "<string>",
        "logo_url": "<string>"
      },
      "position_type": "lending_supply",
      "category": "lending",
      "position_account": "<string>",
      "owner_role": "authority",
      "market": "<string>",
      "assets": [
        {
          "role": "supplied",
          "mint": "<string>",
          "symbol": "<string>",
          "amount_raw": "<string>",
          "decimals": 127,
          "amount": "<string>",
          "price_usd": "<string>",
          "value_usd": "<string>",
          "pricing_source": "<string>",
          "price_as_of": "<string>",
          "valuation_status": "priced",
          "confidence": "qualified",
          "claimable": true,
          "amount_basis": "exact",
          "informational": true,
          "in_totals": true,
          "exclusion_reason": "indicative",
          "context": {
            "account": "<string>",
            "as_of_slot": 123,
            "status": "active",
            "reward_index": 4
          },
          "market_price_usd": "<string>",
          "protocol_mark_price_usd": "<string>",
          "price_warnings": [
            "<string>"
          ]
        }
      ],
      "debts": [
        {
          "role": "supplied",
          "mint": "<string>",
          "symbol": "<string>",
          "amount_raw": "<string>",
          "decimals": 127,
          "amount": "<string>",
          "price_usd": "<string>",
          "value_usd": "<string>",
          "pricing_source": "<string>",
          "price_as_of": "<string>",
          "valuation_status": "priced",
          "confidence": "qualified",
          "claimable": true,
          "amount_basis": "exact",
          "informational": true,
          "in_totals": true,
          "exclusion_reason": "indicative",
          "context": {
            "account": "<string>",
            "as_of_slot": 123,
            "status": "active",
            "reward_index": 4
          },
          "market_price_usd": "<string>",
          "protocol_mark_price_usd": "<string>",
          "price_warnings": [
            "<string>"
          ]
        }
      ],
      "rewards": [
        {
          "role": "supplied",
          "mint": "<string>",
          "symbol": "<string>",
          "amount_raw": "<string>",
          "decimals": 127,
          "amount": "<string>",
          "price_usd": "<string>",
          "value_usd": "<string>",
          "pricing_source": "<string>",
          "price_as_of": "<string>",
          "valuation_status": "priced",
          "confidence": "qualified",
          "claimable": true,
          "amount_basis": "exact",
          "informational": true,
          "in_totals": true,
          "exclusion_reason": "indicative",
          "context": {
            "account": "<string>",
            "as_of_slot": 123,
            "status": "active",
            "reward_index": 4
          },
          "market_price_usd": "<string>",
          "protocol_mark_price_usd": "<string>",
          "price_warnings": [
            "<string>"
          ]
        }
      ],
      "net_value_usd": "<string>",
      "known_value_usd": "<string>",
      "valuation": {
        "status": "complete",
        "priced_leg_count": 123,
        "indicative_leg_count": 123,
        "unpriced_leg_count": 123
      },
      "accounting": {
        "counts_toward_totals": true,
        "parent_position_id": "<string>",
        "carried_forward_from_snapshot": "<string>"
      },
      "flags": [
        "<string>"
      ],
      "evidence": {
        "slot": 123,
        "adapter_version": "<string>",
        "method": "wallet_token",
        "accounts": [
          "<string>"
        ],
        "decoder_hash": "<string>"
      },
      "details": {},
      "warnings": [
        "<string>"
      ]
    }
  ],
  "page": {
    "limit": 123,
    "returned": 123,
    "total_positions": 123,
    "next_cursor": "<string>",
    "page_complete": true
  },
  "totals": {
    "total_value_usd": "<string>",
    "known_value_usd": "<string>",
    "total_null_reasons": [
      "coverage_incomplete"
    ],
    "unpriced_position_count": 123,
    "priced_leg_count": 123,
    "indicative_leg_count": 123,
    "unpriced_leg_count": 123,
    "excluded": {
      "indicative_value_usd": "<string>",
      "stale_value_usd": "<string>",
      "estimated_rewards_value_usd": "<string>",
      "claimable_rewards_not_included_usd": "<string>",
      "staker_only_value_usd": "<string>"
    },
    "valuation_status": "complete",
    "include_rewards_in_total": true,
    "price_sources": [
      {
        "id": "<string>",
        "status": "ok",
        "as_of": "<string>"
      }
    ],
    "note": "<string>",
    "warnings": [
      "<string>"
    ]
  },
  "request": {
    "include": [
      "underlying"
    ],
    "protocols": [
      "<string>"
    ],
    "freshness_seconds": 123,
    "include_rewards_in_total": true,
    "limit": 123
  },
  "metadata": {
    "notice": "<string>",
    "assets": {},
    "protocols": {}
  },
  "tokens": {
    "scan": {
      "spl_token": "complete",
      "token_2022": "complete",
      "native_sol": "complete"
    },
    "holdings": [
      {
        "mint": "<string>",
        "token_program": "native",
        "token_accounts": [
          "<string>"
        ],
        "amount_raw": "<string>",
        "decimals": 127,
        "amount": "<string>",
        "symbol": "<string>",
        "name": "<string>",
        "logo_url": "<string>",
        "verified": true,
        "spam_suspected": true,
        "price_usd": "<string>",
        "value_usd": "<string>",
        "valuation_status": "priced",
        "pricing_source": "<string>",
        "price_as_of": "2023-11-07T05:31:56Z",
        "counted_in_position": "<string>",
        "in_total": true
      }
    ],
    "note": "<string>"
  },
  "tokens_total": {
    "total_value_usd": "<string>",
    "known_value_usd": "<string>",
    "total_null_reasons": [
      "coverage_incomplete"
    ],
    "valuation_status": "complete",
    "priced_count": 123,
    "indicative_count": 123,
    "stale_count": 123,
    "unpriced_count": 123,
    "counted_in_position_count": 123,
    "spam_suspected_count": 123,
    "note": "<string>"
  }
}

Authorizations

Authorization · string · header · required

PRIVATE_API_TOKEN, required on /v1/* (except /v1/health) while configured.

Path Parameters

wallet · string · required

Base58 public key decoding to exactly 32 bytes; case-sensitive.

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$

Query Parameters

include · string

Comma-separated subset of underlying, rewards, valuation, metadata, tokens. Default underlying,rewards,valuation,metadata (tokens, the wallet token balances of D-27, only when asked for).

Maximum string length: 200

Pattern: ^(underlying|rewards|valuation|metadata|tokens)(,(underlying|rewards|valuation|metadata|tokens))*$

protocols · string

Comma-separated adapter ids (see GET /v1/solana/protocols). Default all registered.

Maximum string length: 1000

freshness_seconds · integer

Maximum acceptable snapshot age in seconds. Default 120.

Required range: 0 <= x <= 86400

include_rewards_in_total · enum<string> · default: false

Count claimable reward and fee legs in totals. Requires rewards in include.

Available options: true, false

limit · integer · default: 100

Required range: 1 <= x <= 500

cursor · string

Opaque cursor from page.next_cursor.

Maximum string length: 200

wait · integer · default: 0

Long-poll (D-29). When the request would start or join a refresh scan (202, or a stale 200 with refreshing), hold it open up to this many seconds for the scan; if it finishes in time the response is the normal fresh 200 for the new snapshot, else exactly the response without wait. Counted once against rate limits. 0 (default) returns at once.

Required range: 0 <= x <= 10

Response

200

application/json

Fresh or stale snapshot

chain · string · required

Allowed value: "solana"

network · string · required

Allowed value: "mainnet-beta"

wallet · string · required

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$

snapshot_id · string | null · required

release_status · enum<string> · required

Available options: alpha_partial, v1

as_of · string · required

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$

observed_slots · object · required

Show child attributes

snapshot_consistency · enum<string> · required

Available options: single_slot, multi_slot, unknown

refreshing · boolean · required

refresh_job_id · string | null · required

freshness · object · required

Show child attributes

coverage · object · required

Show child attributes

positions · object[] · required

Show child attributes

page · object · required

Show child attributes

totals · object | null · required

Show child attributes

request · object · required

Show child attributes

metadata · object | null · required

Display metadata for the mints and protocols on this page (14 §7.1); null when metadata is not in include.

Show child attributes

tokens · object | null

D-27 wallet token balances (native SOL plus every non-zero SPL / Token-2022 mint) for the whole snapshot, identical on every page; null unless tokens is in include or when the snapshot predates D-27. Emitted on every 200 since D-27.

Show child attributes

tokens_total · object | null

D-27 separate wallet-token total. Never part of, and never includes, totals. Null unless both tokens and valuation are in include (and the snapshot has a tokens section).

Show child attributes