Overview

Base URL: https://claimr.app/api

Endpoints

Method	Path	What it does
GET	/wallet/lookup	Get address and balance for a Twitter handle
POST	/collect	Move fees from Pump.fun vault to PDA

Both are public - no auth needed.

Rate limits

20 requests per minute per IP. Hit the limit and you'll get a 429 with a Retry-After header.

Errors

{
  "error": "INVALID_HANDLE",
  "message": "Handle must be 1-15 alphanumeric characters"
}

Common ones:

Code	What happened
INVALID_HANDLE	Bad handle format
TWITTER_NOT_FOUND	No Twitter account with that handle
NOTHING_TO_COLLECT	Vault is empty
RATE_LIMITED	Slow down