/wallet/lookup

Look up a Twitter handle and get their Claimr address plus current balance.

Request

GET /api/wallet/lookup?handle=elonmusk

Handle can have the @ or not.

Response

{
  "handle": "elonmusk",
  "twitterId": "44196397",
  "address": "7HbxHbUMZRVCkh2f8YSvXkzLygwjL1vgHEFpHQP8qyEn",
  "balance": {
    "pda": "5.2000",
    "vault": "3.1000",
    "total": "8.3000"
  },
  "totalWithdrawn": "10.5000",
  "canWithdraw": true,
  "withdrawPreview": {
    "gross": "8.3000",
    "fee": "0.1660",
    "net": "8.1340"
  },
  "profile": {
    "name": "Elon Musk",
    "profileImageUrl": "https://pbs.twimg.com/...",
    "verified": true
  }
}

Fields

Field	What it is
twitterId	Numeric ID - use this for /collect calls
address	The Claimr PDA - use as creator address on Pump.fun
balance.pda	Ready to withdraw
balance.vault	Needs collection first
canWithdraw	True if total >= 0.04 SOL
withdrawPreview	What they'd get if they withdrew everything now

Errors

Code	Why
INVALID_HANDLE	Not a valid Twitter handle format
TWITTER_NOT_FOUND	Account doesn't exist