Overview

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

Endpoints

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

No authentication required.

Rate Limits

20 requests per minute per IP. Exceeding the limit returns HTTP 429 with a Retry-After header.

Error Format

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

Error Codes

Lookup Errors

Code	HTTP	Description
HANDLE_REQUIRED	400	No handle parameter provided
INVALID_HANDLE	400	Invalid Twitter handle format
TWITTER_NOT_FOUND	404	Twitter account does not exist
TWITTER_RATE_LIMITED	429	Twitter API rate limit hit
TWITTER_API_UNAVAILABLE	503	Twitter API temporarily unavailable
SERVICE_BUSY	503	Request queue full, retry after 30 seconds
LOOKUP_FAILED	500	Unexpected error

Collect Errors

Code	HTTP	Description
INVALID_TWITTER_ID	400	Missing or non-numeric Twitter ID
NOTHING_TO_COLLECT	400	Vault is empty
INSUFFICIENT_FUNDS	500	Fee payer wallet has insufficient SOL
COLLECT_FAILED	500	Transaction failed

Global

Code	HTTP	Description
RATE_LIMITED	429	Rate limit exceeded (20 req/min per IP)