# debundle

> unofficial screener for pons. Screener and API for tokens launched on pons (Robinhood Chain, chain id 4663). It separates organic volume (many real buyers) from bundled and wash volume. Unofficial. Not affiliated with pons or Pons Labs.

The organic score is a heuristic, not proof and not financial advice.

## API

- Base URL: https://debundle.xyz/api/v1
- Auth: `Authorization: Bearer psk_live_...` or `x-api-key`. Create a key at https://debundle.xyz/dashboard by signing in with a wallet.
- Rate limits: free 60 requests/minute, pro 600. Headers X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
- Responses: `{ data, meta }`; meta has indexedBlock, lagSeconds, scoreVersion and page.nextCursor. Errors: `{ error: { code, message } }`.
- Wei amounts are strings; ETH and USD amounts are numbers.
- OpenAPI 3.1: https://debundle.xyz/api/v1/openapi.json
- Human docs: https://debundle.xyz/docs

## Endpoints

- GET /status (no key): indexer head and lag
- GET /stats
- GET /feeds/{new|hot-new|trending|near-graduation|graduated}
- GET /tokens: filters minAgeMin, maxAgeMin, minMcap, maxMcap, minLiquidity, maxLiquidity, minVolume, maxVolume, minOrganicVolume, maxOrganicVolume, minScore, maxScore, label, minBuyers, minEntities, minHolders, maxHolders, maxTop10Pct, maxDevPct, devSold, hasSocials, minProgress, maxProgress, graduated, version, minCreatorTaxBps, maxCreatorTaxBps, pairToken, q; sort, order, limit, cursor
- GET /tokens/{address}, /tokens/{address}/trades, /tokens/{address}/score, /tokens/{address}/holders, /tokens/{address}/candles
- GET /deployers/{address}, GET /wallets/{address}
- GET/POST /webhooks, DELETE /webhooks/{id}: events token.launched, token.hot, token.graduated, token.score_changed, HMAC-signed

## MCP

- Streamable HTTP endpoint: https://debundle.xyz/api/mcp (same API key as a Bearer token)
- Tools: get_feed, search_tokens, get_token, get_token_score, get_deployer, get_wallet

## Organic score

100 minus the weighted sum of nine metrics, each 0 to 1 over buy volume in a window (launch = first 30 minutes, 1h, 24h). Labels: 70+ organic, 40 to 69 mixed, below 40 bundled; fewer than 20 buys or 10 buyers gives insufficient_data and a null score.

- cluster_share: weight 25
- dev_linked_share: weight 15
- top10_entity_share: weight 15
- fresh_share: weight 10
- early_burst_share: weight 10
- wash_share: weight 10
- uniform_size_share: weight 5
- via_contract_share: weight 5
- low_persistence: weight 5

Wallets are clustered into entities when they share a first funder, fund each other, are funded by the deployer, or receive buys from one transaction. Hub funders (bridges, exchanges) never link wallets.