Skip to main content
Polling is a good fit when you want a periodic reconciliation job (for example, every 1–5 minutes) and can tolerate some delay compared to webhooks.

​
List and lookup wallets

cURL
curl -X GET "$BASE_URL/v2/portfolio-wallets?pageSize=25" \
  -H "Authorization: Bearer $TOKEN"
Next page:
cURL
curl -X GET "$BASE_URL/v2/portfolio-wallets?pageSize=25&cursor=$NEXT_CURSOR" \
  -H "Authorization: Bearer $TOKEN"
Get a wallet by id:
cURL
curl -X GET "$BASE_URL/v2/portfolio-wallets/$WALLET_ID" \
  -H "Authorization: Bearer $TOKEN"
Lookup by requestId or label:
cURL
curl -X GET "$BASE_URL/v2/portfolio-wallets/lookup?requestId=$REQUEST_ID" \
  -H "Authorization: Bearer $TOKEN"
cURL
curl -X GET "$BASE_URL/v2/portfolio-wallets/lookup?label=My%20Portfolio" \
  -H "Authorization: Bearer $TOKEN"

​
Yield metrics

Portfolio yield metrics are computed via:
cURL
curl -X POST "$BASE_URL/v2/portfolio-wallets/yield" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{
    \"periodStartIso\": \"2026-01-01T00:00:00Z\",
    \"periodEndIso\": \"2026-02-01T00:00:00Z\",
    \"portfolioWalletIds\": [\"$WALLET_ID\"]
  }"