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)

Last updated