Quick Start

Two API calls cover 90% of what you'll need.

Look up a handle

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

You get back their Claimr address, current balance, and Twitter info:

{
  "handle": "elonmusk",
  "twitterId": "44196397",
  "address": "7HbxHbUMZRVCkh2f8YSvXkzLygwjL1vgHEFpHQP8qyEn",
  "balance": {
    "pda": "5.2000",
    "vault": "3.1000",
    "total": "8.3000"
  },
  "canWithdraw": true
}

The address is what you use as the creator when launching tokens.

Trigger collection

Fees from trading sit in a Pump.fun vault until someone moves them. This call does that:

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

Note: you need the Twitter ID (numeric), not the handle. The lookup response includes it.

That's it for integration

Withdrawals happen on claimr.app - the user logs in with Twitter and picks where to send funds. You don't need to build anything for that part.