Pagination

Page through positions with limit and cursor.

limit (1…500, default 100) and cursor (from page.next_cursor) page through positions. coverage and totals are computed over all positions on every page, so you never need every page to show an honest summary. page.page_complete is true on the last page.

tokens (with include=tokens) covers the whole snapshot and is identical on every page.

Parameters

limit · integer · default: "100"

1…500.

cursor · string

Opaque, from page.next_cursor. A cursor for a pruned or too-old snapshot → 400 CURSOR_EXPIRED (restart from the first page); a cursor from another wallet or other filters → 400 INVALID_PARAMETER.

BASE_URL="https://api.lucidblock.xyz"
curl -s -H "Authorization: Bearer $LUCIDBLOCK_TOKEN" "$BASE_URL/v1/solana/wallets/$W/defi-positions?limit=50"
# then pass page.next_cursor back, with the same filters, until page.page_complete is true:
curl -s -H "Authorization: Bearer $LUCIDBLOCK_TOKEN" "$BASE_URL/v1/solana/wallets/$W/defi-positions?limit=50&cursor=<next_cursor>"

Page

limit · integer · required

returned · integer · required

total_positions · integer · required

next_cursor · string | null · required

page_complete · boolean · required