Two Addresses

Funds can reside in two locations. Understanding the distinction is important for integration.

Pump.fun Vault

When a token trades on Pump.fun, creator fees accumulate in a vault controlled by Pump.fun. Fees remain there until the creator collects them.

Claimr PDA

The address tied to a Twitter account. After collection, funds reside here until the owner withdraws.

Comparison

Vault
PDA

Controlled by

Pump.fun

Claimr

API field

balance.vault

balance.pda

Withdrawable

No, requires collection

Yes

Collection

Call /api/collect to move funds from the vault to the PDA:

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

This is permissionless. Anyone can trigger collection; funds always go to the owner's PDA.

When to Collect

Trigger collection before displaying a withdrawable balance. Otherwise the displayed amount may exclude funds still in the vault.

Collection transaction fees (~0.00005 SOL) are covered by Claimr.

Last updated