Skip to main content

PONS Claimable Balance

Read-only view of what a creator wallet can claim on Robinhood Chain: the balance the PONS Fee Escrow already holds for the wallet, plus the fees still sitting on the bonding curves of the tokens you name. Nothing is built, signed or sent — call this before every claim.

API Endpoint: GET https://rhc.pumpdev.io/api/claim-account — no API key.

Fees from live trading stay on each token's curve until a claim sweeps them, so a call without tokens reports only what is already in the escrow. Pass the tokens you created to see the whole picture.

Once you know the number, claim it with POST /api/claim-local from your own wallet, or with POST /api/claim-lightning from a Lightning wallet.

Query Parameters​

ParameterTypeRequiredDescription
publicKeystringYesCreator wallet address
tokensstringNoComma-separated token addresses whose curves to read (max 10)

Response​

{
  "publicKey": "0x…",
  "claimable": "1704942013199998",
  "claimableEth": "0.001704942013199998",
  "escrowBalance": "1562787000000000",
  "pending": "142155013199998",
  "tokens": [
    {
      "token": "0x1Fb5…ABF9",
      "curve": "0xDbfE…7989",
      "pending": "142155013199998",
      "graduated": false,
      "buybackEnabled": false
    }
  ],
  "feeBps": 50,
  "delegated": false,
  "delegatedTo": null
}
FieldDescription
claimableescrowBalance + pending: what a claim with these tokens collects, in wei
claimableEthThe same figure in ETH, for display
escrowBalanceWhat the escrow already holds for this wallet — one balance for every token you created
pendingFees still sitting on the curves of the tokens you passed
tokens[]Per token: its curve, the pending fees on it, graduated (fees then accrue on the Uniswap hook and reach the escrow when PONS sweeps), buybackEnabled (a slice of pending is spent on buybacks at sweep time, so it is an upper bound), or an error (Not a PONS V2 token, Custom-pair fees are not supported yet)
feeBpsPumpDev's commission on the amount claimed, in basis points (50 = 0.5% on the client-signed route)
delegatedtrue once the claim delegate is installed on the wallet — later claims skip the authorization
delegatedToThe delegate currently installed, if any (the Lightning delegate shows here as delegated: false)

Example​

const API_URL = "https://rhc.pumpdev.io";
const WALLET = "0x…";
const MY_TOKENS = ["0x…", "0x…"]; // tokens you created that are still on their curve

const balance = await (await fetch(
  `${API_URL}/api/claim-account?publicKey=${WALLET}&tokens=${MY_TOKENS.join(",")}`,
)).json();

console.log(`Claimable: ${balance.claimableEth} ETH`);
console.log(`  in escrow: ${balance.escrowBalance} wei`);
console.log(`  on curves: ${balance.pending} wei`);

for (const t of balance.tokens) {
  if (t.error) console.log(`  ${t.token}: ${t.error}`);
  else console.log(`  ${t.token}: ${t.pending} wei${t.graduated ? " (graduated)" : ""}`);
}

Limits in this version​

  • ETH-quoted tokens only. Fees on tokens paired with an ERC-20 (balanceOfToken) are not shown or claimed; such a token comes back with error: "Custom-pair fees are not supported yet".
  • Graduated pools. After graduation fees accrue on the Uniswap V4 hook until PONS sweeps them into the escrow; this endpoint reports the token as graduated: true and counts only what reached the escrow.

Error Handling​

ErrorCauseFix
publicKey is required / Invalid publicKeyMissing or malformed addressPass a 0x address
Invalid token address: … / Maximum 10 tokens per claimBad or too many tokensPass up to 10 0x addresses
Claim is not configured on this server (503)No delegate on this deployment—

Next Steps​

Last updated on