DOCUMENTATION

API REFERENCE & GUIDES

Integrate ClaimScan into your app. Scan fees, claim tokens, export data.

Introduction

ClaimScan scans 10 launchpads across 4 chains and shows what creators earned, claimed, and left uncollected. Paste a handle or wallet. Get a full fee breakdown in seconds.

Base URL

https://claimscan.tech

Supported Chains

Chain	Chain ID	Decimals	Platforms
Solana	N/A	9	Pump.fun, Bags.fm, Believe, RevShare, Coinbarrel, Raydium
Base	8453	18	Clanker, Zora, Bankr
Ethereum	1	18	Zora
BSC	56	18	Clanker

Token amounts are BigInt strings. Do not convert to Number. Precision loss will corrupt balances.

Supported Platforms

10 platforms across Solana, Base, and BNB Chain.

Solana6 platforms

Pump.funLargest memecoin launchpad

Bags.fmSocial token trading

BelieveCommunity token launches

RevShareRevenue sharing

CoinbarrelFast token launches

RaydiumDEX LP fee tracking

Base / ETH / BSC3 platforms

ClankerFarcaster launcher (Base + BSC)

ZoraProtocol rewards (Base + ETH)

BankrAI trading fee splits (Base)

How It Works

Scan any creator in under 30 seconds. No wallet connection required.

1
Enter a handle
Twitter, Farcaster, GitHub username, or raw wallet address.
2
Identity resolution
Social handles resolved to wallet addresses across all supported chains.
3
Parallel platform scan
All 10 platforms queried simultaneously. Results stream in real time.
4
Fee aggregation
Earned, claimed, and unclaimed fees pulled per token. Duplicates filtered.
5
USD conversion
Live prices via DexScreener, Jupiter, and CoinGecko. Auto-refreshed.
6
Live dashboard
Platform breakdown, chain breakdown, token-level details. Auto-refreshes.

All scanning is read-only. No wallet connection required. No signatures. No transaction risk.

Claim Flow

Claim uncollected fees without leaving ClaimScan. Zero-custody flow: transactions built server-side, simulated before you sign, submitted on-chain. Your private keys never leave your wallet.

1Claimable positions fetched from the platform

2Transaction built and simulated server-side

3You sign in your wallet (Phantom, Solflare, Backpack, etc.)

4Transaction submitted and confirmed on-chain

Bags.fm · LiveClanker · ComingZora · Coming

Authentication

Free endpoints (search, leaderboard, prices) need no authentication. Cloudflare Turnstile is required for /api/search and /api/resolve.

Request Signing

HMAC-SHA256 via X-Request-Sig header. 30-second validity window. Recommended for server-to-server calls.

V2 Paid Endpoints

V2 endpoints use the x402 protocol. Pay per query in USDC on Base. No API keys, no subscriptions.

bash

# Free endpoint
curl -X POST https://claimscan.tech/api/search \
  -H "Content-Type: application/json" \
  -d '{"query": "finnbags"}'

# V2 paid endpoint (x402)
curl https://claimscan.tech/api/v2/fees?wallet=0x... \
  -H "Authorization: Bearer {x402_token}"

Rate Limits

All limits are per IP. Exceeding them returns 429 Too Many Requests.

Endpoint	Limit	Notes
/api/search	10 req/min	Turnstile required
/api/resolve	10 req/min	Turnstile required
/api/fees/live	5 req/min	Onchain reads
Other /api/*	30 req/min	General
Handle enum	20 handles/5min	Anti-enumeration

Max POST body: 4KB. User-Agent header required on all requests. Known scraper agents are blocked.

Search by Handle

POST/api/search

Resolves a social handle (Twitter, GitHub, Farcaster) or wallet address to a creator identity. Returns the creator profile, all linked wallets, and aggregated fee records across all 10 platforms and 4 chains.

Parameters

queryrequired

Social handle or wallet address. 2-256 characters.

cfTurnstileTokenoptional

Cloudflare Turnstile verification token. Required from browsers.

Response

json

{
  "creator": {
    "handle": "finnbags",
    "platform": "twitter",
    "avatar": "https://pbs.twimg.com/..."
  },
  "wallets": [
    "So1anaWa11etAddress...",
    "0xEvmWalletAddress..."
  ],
  "fees": [
    {
      "platform": "bags",
      "chain": "sol",
      "token_mint": "TokenMintAddress...",
      "token_name": "BAGS",
      "total_earned": "1500000000",
      "claimed": "500000000",
      "unclaimed": "1000000000",
      "usd_value": 142.50
    }
  ],
  "cached": true,
  "refreshing": false
}

Get Fees (V2)

GET/api/v2/fees

Price:$0.01/queryvia x402

Returns every fee record for a wallet across all 10 platforms and 4 chains. Each record includes earned, claimed, unclaimed amounts (BigInt) and current USD value.

Parameters

walletrequired

Solana base58 or EVM 0x address

Response

json

{
  "wallet": "So1anaWa11etAddress...",
  "fees": [
    {
      "platform": "pump",
      "chain": "sol",
      "token_mint": "TokenMintAddress...",
      "token_name": "PUMP",
      "total_earned": "2500000000",
      "claimed": "1000000000",
      "unclaimed": "1500000000",
      "usd_value": 312.75
    }
  ],
  "summary": {
    "totalEarnedUsd": 4820.50,
    "totalUnclaimedUsd": 1930.25,
    "totalRecords": 24,
    "platforms": 5,
    "chains": 2
  },
  "paidVia": "x402"
}

bash

curl https://claimscan.tech/api/v2/fees?wallet=So1anaWa11etAddress...

Export Data

GET/api/v2/export

Price:$0.05/queryvia x402

Download fee data as CSV or JSON. CSV response includes a Content-Disposition header for direct file save. Limit: 1,000 records per request.

Parameters

walletrequired

Solana base58 or EVM 0x address

formatoptional

csv or json. Defaults to csv.

bash

# Export as CSV (default)
curl https://claimscan.tech/api/v2/export?wallet=0xEvmAddress... \
  -o fees.csv

# Export as JSON
curl https://claimscan.tech/api/v2/export?wallet=0xEvmAddress...&format=json

Leaderboard

GET/api/leaderboard

Top creators ranked by total fees earned (USD). Free endpoint, no auth. Filter by platform or chain. Paginated, max 100 results per page.

Parameters

limitoptional

Results per page. Default 50, max 100.

offsetoptional

Number of results to skip for pagination. Default 0.

platformoptional

Filter by platform (e.g. bags, pump, clanker)

chainoptional

Filter by chain (sol, base, eth, bsc)

bash

curl "https://claimscan.tech/api/leaderboard?limit=50&offset=0&platform=bags&chain=sol"

Response

json

{
  "creators": [
    {
      "handle": "finnbags",
      "total_earned_usd": 52340.12,
      "unclaimed_usd": 12500.00,
      "platforms": 5,
      "tokens": 38
    }
  ],
  "total": 1240,
  "limit": 50,
  "offset": 0
}

Security & Privacy

ClaimScan never touches your wallet or stores your data. That's the architecture, not a promise.

Private searches

Search queries are never stored in readable form.

Server-side only

All sensitive operations run server-side. No secrets reach the browser.

Zero-custody claims

Transactions built and simulated server-side. You sign and submit from your wallet.

Signed requests

Every claim request is cryptographically verified end-to-end.

Tamper-proof claims

Claim states are immutable once finalized. Cannot be rolled back.

On-chain verifiable

Every fee record and claim transaction is independently verifiable on-chain.

Architecture

FrontendNext.js, React, Tailwind CSS

BlockchainSolana + EVM (Base, Ethereum, BSC)

DatabaseSupabase (PostgreSQL + RLS)

CacheUpstash Redis + in-memory fallback

Price FeedsDexScreener, Jupiter, CoinGecko

IdentityTwitter, GitHub, Farcaster, OWS wallet resolution

Paymentsx402 protocol (USDC on Base)

SecuritySentry, Cloudflare Turnstile, request signing

DeploymentVercel (serverless)

Frequently Asked Questions

How does ClaimScan work?

Paste a social handle or wallet address. ClaimScan resolves it to wallets and scans 10 platforms across Solana, Base, Ethereum, and BNB Chain in parallel, showing earned, claimed, and unclaimed fees in real time.

What platforms are supported?

10 platforms: Pump.fun, Bags.fm, Believe, RevShare, Coinbarrel, and Raydium on Solana, plus Clanker, Zora, Bankr, and Flaunch on Base/ETH/BSC.

Is ClaimScan free?

Yes. Scanning, viewing fee data, and the leaderboard are completely free. No API key needed. V2 paid endpoints for developers and agents use pay-per-query pricing via the x402 protocol.

How do I claim fees?

Connect your wallet on a profile page and click Claim on eligible unclaimed fees. ClaimScan builds the transaction server-side, simulates it, and you sign in your wallet. Currently live for Bags.fm with others coming soon.

Is ClaimScan safe?

Yes. Scanning is fully read-only. Claims are zero-custody. Transactions are built server-side with pre-sign simulation. ClaimScan never has access to your private keys.

API Pricing

Free for scanning. Pay-per-query for programmatic access via x402.

Free

Scanning, leaderboard, and price feeds. No auth required.

Fee scanning

Leaderboard access

Price feeds

No auth needed

Pay-per-query

x402

V2 endpoints. USDC on Base. No API keys or subscriptions.

/v2/resolve: $0.01/query

/v2/fees: $0.01/query

/v2/export: $0.05/query

/v2/intelligence: $0.02/query

USDC on Base

Privacy: all creator data exposed via the V2 API is already public. Paying unlocks fast lookup, not access to private data.

Enterprise

Custom

Custom rate limits, volume pricing, and dedicated support.

Custom rate limits

Volume discounts

Dedicated support

Contact @lwarts on Telegram

Roadmap

V1.5Current · Live

9 platform support (Solana + Base + BSC)

Multi-identity search (Twitter, GitHub, Farcaster, Wallet)

Real-time streaming scan results

Bags.fm direct claim (zero-custody)

Pre-sign transaction simulation

Smart caching with background indexing

Multi-source USD price aggregation

V2 paid API via x402 protocol

Rate limiting and abuse prevention

Privacy-preserving analytics

V2Coming Soon

Token Fee Scanner (paste any contract address)

Fee recipient discovery

One-click claim expansion (Clanker & Zora)

Additional chain support (Arbitrum)

SDK for platform integrations

Introduction

ClaimScan scans 10 launchpads across 4 chains and shows what creators earned, claimed, and left uncollected. Paste a handle or wallet. Get a full fee breakdown in seconds.

Base URL

https://claimscan.tech

Supported Chains

Chain	Chain ID	Decimals	Platforms
Solana	N/A	9	Pump.fun, Bags.fm, Believe, RevShare, Coinbarrel, Raydium
Base	8453	18	Clanker, Zora, Bankr
Ethereum	1	18	Zora
BSC	56	18	Clanker

Token amounts are BigInt strings. Do not convert to Number. Precision loss will corrupt balances.

Supported Platforms

10 platforms across Solana, Base, and BNB Chain.

Solana6 platforms

Pump.funLargest memecoin launchpad

Bags.fmSocial token trading

BelieveCommunity token launches

RevShareRevenue sharing

CoinbarrelFast token launches

RaydiumDEX LP fee tracking

Base / ETH / BSC3 platforms

ClankerFarcaster launcher (Base + BSC)

ZoraProtocol rewards (Base + ETH)

BankrAI trading fee splits (Base)

How It Works

Scan any creator in under 30 seconds. No wallet connection required.

1
Enter a handle
Twitter, Farcaster, GitHub username, or raw wallet address.
2
Identity resolution
Social handles resolved to wallet addresses across all supported chains.
3
Parallel platform scan
All 10 platforms queried simultaneously. Results stream in real time.
4
Fee aggregation
Earned, claimed, and unclaimed fees pulled per token. Duplicates filtered.
5
USD conversion
Live prices via DexScreener, Jupiter, and CoinGecko. Auto-refreshed.
6
Live dashboard
Platform breakdown, chain breakdown, token-level details. Auto-refreshes.

All scanning is read-only. No wallet connection required. No signatures. No transaction risk.

Claim Flow

Claim uncollected fees without leaving ClaimScan. Zero-custody flow: transactions built server-side, simulated before you sign, submitted on-chain. Your private keys never leave your wallet.

1Claimable positions fetched from the platform

2Transaction built and simulated server-side

3You sign in your wallet (Phantom, Solflare, Backpack, etc.)

4Transaction submitted and confirmed on-chain

Bags.fm · LiveClanker · ComingZora · Coming

Authentication

Free endpoints (search, leaderboard, prices) need no authentication. Cloudflare Turnstile is required for /api/search and /api/resolve.

Request Signing

HMAC-SHA256 via X-Request-Sig header. 30-second validity window. Recommended for server-to-server calls.

V2 Paid Endpoints

V2 endpoints use the x402 protocol. Pay per query in USDC on Base. No API keys, no subscriptions.

bash

# Free endpoint
curl -X POST https://claimscan.tech/api/search \
  -H "Content-Type: application/json" \
  -d '{"query": "finnbags"}'

# V2 paid endpoint (x402)
curl https://claimscan.tech/api/v2/fees?wallet=0x... \
  -H "Authorization: Bearer {x402_token}"

Rate Limits

All limits are per IP. Exceeding them returns 429 Too Many Requests.

Endpoint	Limit	Notes
/api/search	10 req/min	Turnstile required
/api/resolve	10 req/min	Turnstile required
/api/fees/live	5 req/min	Onchain reads
Other /api/*	30 req/min	General
Handle enum	20 handles/5min	Anti-enumeration

Max POST body: 4KB. User-Agent header required on all requests. Known scraper agents are blocked.

Search by Handle

POST/api/search

Parameters

queryrequired

Social handle or wallet address. 2-256 characters.

cfTurnstileTokenoptional

Cloudflare Turnstile verification token. Required from browsers.

Response

json

{
  "creator": {
    "handle": "finnbags",
    "platform": "twitter",
    "avatar": "https://pbs.twimg.com/..."
  },
  "wallets": [
    "So1anaWa11etAddress...",
    "0xEvmWalletAddress..."
  ],
  "fees": [
    {
      "platform": "bags",
      "chain": "sol",
      "token_mint": "TokenMintAddress...",
      "token_name": "BAGS",
      "total_earned": "1500000000",
      "claimed": "500000000",
      "unclaimed": "1000000000",
      "usd_value": 142.50
    }
  ],
  "cached": true,
  "refreshing": false
}

Get Fees (V2)

GET/api/v2/fees

Price:$0.01/queryvia x402

Returns every fee record for a wallet across all 10 platforms and 4 chains. Each record includes earned, claimed, unclaimed amounts (BigInt) and current USD value.

Parameters

walletrequired

Solana base58 or EVM 0x address

Response

json

{
  "wallet": "So1anaWa11etAddress...",
  "fees": [
    {
      "platform": "pump",
      "chain": "sol",
      "token_mint": "TokenMintAddress...",
      "token_name": "PUMP",
      "total_earned": "2500000000",
      "claimed": "1000000000",
      "unclaimed": "1500000000",
      "usd_value": 312.75
    }
  ],
  "summary": {
    "totalEarnedUsd": 4820.50,
    "totalUnclaimedUsd": 1930.25,
    "totalRecords": 24,
    "platforms": 5,
    "chains": 2
  },
  "paidVia": "x402"
}

bash

curl https://claimscan.tech/api/v2/fees?wallet=So1anaWa11etAddress...

Export Data

GET/api/v2/export

Price:$0.05/queryvia x402

Download fee data as CSV or JSON. CSV response includes a Content-Disposition header for direct file save. Limit: 1,000 records per request.

Parameters

walletrequired

Solana base58 or EVM 0x address

formatoptional

csv or json. Defaults to csv.

bash

# Export as CSV (default)
curl https://claimscan.tech/api/v2/export?wallet=0xEvmAddress... \
  -o fees.csv

# Export as JSON
curl https://claimscan.tech/api/v2/export?wallet=0xEvmAddress...&format=json

Leaderboard

GET/api/leaderboard

Top creators ranked by total fees earned (USD). Free endpoint, no auth. Filter by platform or chain. Paginated, max 100 results per page.

Parameters

limitoptional

Results per page. Default 50, max 100.

offsetoptional

Number of results to skip for pagination. Default 0.

platformoptional

Filter by platform (e.g. bags, pump, clanker)

chainoptional

Filter by chain (sol, base, eth, bsc)

bash

curl "https://claimscan.tech/api/leaderboard?limit=50&offset=0&platform=bags&chain=sol"

Response

json

{
  "creators": [
    {
      "handle": "finnbags",
      "total_earned_usd": 52340.12,
      "unclaimed_usd": 12500.00,
      "platforms": 5,
      "tokens": 38
    }
  ],
  "total": 1240,
  "limit": 50,
  "offset": 0
}

Security & Privacy

ClaimScan never touches your wallet or stores your data. That's the architecture, not a promise.

Private searches

Search queries are never stored in readable form.

Server-side only

All sensitive operations run server-side. No secrets reach the browser.

Zero-custody claims

Transactions built and simulated server-side. You sign and submit from your wallet.

Signed requests

Every claim request is cryptographically verified end-to-end.

Tamper-proof claims

Claim states are immutable once finalized. Cannot be rolled back.

On-chain verifiable

Every fee record and claim transaction is independently verifiable on-chain.

Architecture

FrontendNext.js, React, Tailwind CSS

BlockchainSolana + EVM (Base, Ethereum, BSC)

DatabaseSupabase (PostgreSQL + RLS)

CacheUpstash Redis + in-memory fallback

Price FeedsDexScreener, Jupiter, CoinGecko

IdentityTwitter, GitHub, Farcaster, OWS wallet resolution

Paymentsx402 protocol (USDC on Base)

SecuritySentry, Cloudflare Turnstile, request signing

DeploymentVercel (serverless)

Frequently Asked Questions

How does ClaimScan work?

What platforms are supported?

10 platforms: Pump.fun, Bags.fm, Believe, RevShare, Coinbarrel, and Raydium on Solana, plus Clanker, Zora, Bankr, and Flaunch on Base/ETH/BSC.

Is ClaimScan free?

Yes. Scanning, viewing fee data, and the leaderboard are completely free. No API key needed. V2 paid endpoints for developers and agents use pay-per-query pricing via the x402 protocol.

How do I claim fees?

Is ClaimScan safe?

Yes. Scanning is fully read-only. Claims are zero-custody. Transactions are built server-side with pre-sign simulation. ClaimScan never has access to your private keys.

API Pricing

Free for scanning. Pay-per-query for programmatic access via x402.

Free

Scanning, leaderboard, and price feeds. No auth required.

Fee scanning

Leaderboard access

Price feeds

No auth needed

Pay-per-query

x402

V2 endpoints. USDC on Base. No API keys or subscriptions.

/v2/resolve: $0.01/query

/v2/fees: $0.01/query

/v2/export: $0.05/query

/v2/intelligence: $0.02/query

USDC on Base

Privacy: all creator data exposed via the V2 API is already public. Paying unlocks fast lookup, not access to private data.

Enterprise

Custom

Custom rate limits, volume pricing, and dedicated support.

Custom rate limits

Volume discounts

Dedicated support

Contact @lwarts on Telegram

Roadmap

V1.5Current · Live

9 platform support (Solana + Base + BSC)

Multi-identity search (Twitter, GitHub, Farcaster, Wallet)

Real-time streaming scan results

Bags.fm direct claim (zero-custody)

Pre-sign transaction simulation

Smart caching with background indexing

Multi-source USD price aggregation

V2 paid API via x402 protocol

Rate limiting and abuse prevention

Privacy-preserving analytics

V2Coming Soon

Token Fee Scanner (paste any contract address)

Fee recipient discovery

One-click claim expansion (Clanker & Zora)

Additional chain support (Arbitrum)

SDK for platform integrations

Introduction

Supported Chains

Supported Platforms

How It Works

Enter a handle

Identity resolution

Parallel platform scan

Fee aggregation

USD conversion

Live dashboard

Claim Flow

Authentication

Request Signing

V2 Paid Endpoints

Rate Limits

Search by Handle

Parameters

Response

Get Fees (V2)

Parameters

Response

Export Data

Parameters

Leaderboard

Parameters

Response

Security & Privacy

Private searches

Server-side only

Zero-custody claims

Signed requests

Tamper-proof claims

On-chain verifiable

Architecture

Frequently Asked Questions

How does ClaimScan work?

What platforms are supported?

Is ClaimScan free?

How do I claim fees?

Is ClaimScan safe?

API Pricing

Roadmap

Introduction

Supported Chains

Supported Platforms

How It Works

Enter a handle

Identity resolution

Parallel platform scan

Fee aggregation

USD conversion

Live dashboard

Claim Flow

Authentication

Request Signing

V2 Paid Endpoints

Rate Limits

Search by Handle

Parameters

Response

Get Fees (V2)

Parameters

Response

Export Data

Parameters

Leaderboard

Parameters

Response

Security & Privacy

Private searches

Server-side only

Zero-custody claims

Signed requests

Tamper-proof claims

On-chain verifiable

Architecture

Frequently Asked Questions

How does ClaimScan work?

What platforms are supported?

Is ClaimScan free?