Monitor Balance

Track fee accumulation for accounts.

Query Balance

curl "https://claimr.app/api/wallet/lookup?handle=elonmusk"

{
  "balance": {
    "pda": "1.7000",
    "vault": "0.5000",
    "total": "2.2000"
  },
  "totalWithdrawn": "5.0000"
}

Field	Description
pda	Available for withdrawal
vault	Requires collection
total	Combined balance
totalWithdrawn	Lifetime withdrawals

Automated Collection

When tracking multiple accounts, trigger collection periodically:

curl -X POST https://claimr.app/api/collect \
  -H "Content-Type: application/json" \
  -d '{"twitterId": "44196397"}'

This consolidates funds in the PDA.

Rate Limits

20 requests per minute per IP. Twitter profile data is cached for 24 hours; balances are fetched live from Solana.

For real-time monitoring, query Solana directly using the PDA address from the lookup response.