{"openapi":"3.1.0","info":{"title":"debundle API","version":"1.0.0","description":"unofficial screener for pons. Unofficial. Not affiliated with pons or Pons Labs. The organic score is a heuristic, not proof and not financial advice. Wei values are strings, ETH and USD values are numbers. Every response is { data, meta } and every error is { error: { code, message } }."},"servers":[{"url":"https://debundle.xyz/api/v1"}],"security":[{"bearer":[]},{"apiKey":[]}],"tags":[{"name":"tokens"},{"name":"feeds"},{"name":"profiles"},{"name":"protocol"},{"name":"webhooks"}],"paths":{"/status":{"get":{"tags":["protocol"],"summary":"Indexer head and lag. No API key needed.","security":[],"responses":{"200":{"description":"Indexer state","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/stats":{"get":{"tags":["protocol"],"summary":"Protocol summary over the last 24h","responses":{"200":{"description":"Stats","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/feeds/{feed}":{"get":{"tags":["feeds"],"summary":"Preset feeds: new, hot-new (young, organic, many entities), trending, near-graduation, graduated","parameters":[{"name":"feed","in":"path","required":true,"description":"Feed name.","schema":{"type":"string","enum":["new","hot-new","trending","near-graduation","graduated"]}},{"name":"period","in":"query","required":false,"schema":{"default":"1h","type":"string","enum":["5m","1h","24h"]},"description":"trending only."},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100},"description":"Page size, 1 to 100."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":512},"description":"Opaque cursor from meta.page.nextCursor."}],"responses":{"200":{"description":"Tokens","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Token"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/tokens":{"get":{"tags":["tokens"],"summary":"Screen tokens with any combination of filters","parameters":[{"name":"minAgeMin","in":"query","required":false,"schema":{"type":"number","minimum":0},"description":"Minimum age in minutes."},{"name":"maxAgeMin","in":"query","required":false,"schema":{"type":"number","minimum":0},"description":"Maximum age in minutes."},{"name":"minMcap","in":"query","required":false,"schema":{"type":"number"},"description":"USD."},{"name":"maxMcap","in":"query","required":false,"schema":{"type":"number"},"description":"USD."},{"name":"minLiquidity","in":"query","required":false,"schema":{"type":"number"},"description":"USD."},{"name":"maxLiquidity","in":"query","required":false,"schema":{"type":"number"},"description":"USD."},{"name":"minVolume","in":"query","required":false,"schema":{"type":"number"},"description":"24h total volume, USD."},{"name":"maxVolume","in":"query","required":false,"schema":{"type":"number"},"description":"24h total volume, USD."},{"name":"minOrganicVolume","in":"query","required":false,"schema":{"type":"number"},"description":"24h organic volume, USD."},{"name":"maxOrganicVolume","in":"query","required":false,"schema":{"type":"number"},"description":"24h organic volume, USD."},{"name":"minScore","in":"query","required":false,"schema":{"type":"number","minimum":0,"maximum":100}},{"name":"maxScore","in":"query","required":false,"schema":{"type":"number","minimum":0,"maximum":100}},{"name":"label","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated: organic,mixed,bundled,insufficient_data."},{"name":"minBuyers","in":"query","required":false,"schema":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},{"name":"minEntities","in":"query","required":false,"schema":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},{"name":"minHolders","in":"query","required":false,"schema":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},{"name":"maxHolders","in":"query","required":false,"schema":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},{"name":"maxTop10Pct","in":"query","required":false,"schema":{"type":"number","minimum":0,"maximum":100},"description":"Top-10 holder share in percent, excluding pool, locker and burn."},{"name":"maxDevPct","in":"query","required":false,"schema":{"type":"number","minimum":0,"maximum":100},"description":"Deployer holding in percent."},{"name":"devSold","in":"query","required":false,"schema":{"type":"string","enum":["true","false"]}},{"name":"hasSocials","in":"query","required":false,"schema":{"type":"string","enum":["true","false"]}},{"name":"minProgress","in":"query","required":false,"schema":{"type":"number","minimum":0,"maximum":1},"description":"Graduation progress 0 to 1."},{"name":"maxProgress","in":"query","required":false,"schema":{"type":"number","minimum":0,"maximum":1}},{"name":"graduated","in":"query","required":false,"schema":{"type":"string","enum":["true","false"]}},{"name":"version","in":"query","required":false,"schema":{"type":"string","enum":["v1","v2"]}},{"name":"minCreatorTaxBps","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"v2 only."},{"name":"maxCreatorTaxBps","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"v2 only."},{"name":"pairToken","in":"query","required":false,"schema":{"example":"0x39dbed3a2bd333467115de45665cc57f813c4571","type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"description":"v2 only: quote asset address."},{"name":"q","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":64},"description":"Name, symbol or address search."},{"name":"sort","in":"query","required":false,"schema":{"default":"launched","type":"string","enum":["launched","age","mcap","liquidity","volume24h","organicVolume5m","organicVolume1h","organicVolume24h","score","buyers","entities","holders","progress","graduatedAt"]}},{"name":"order","in":"query","required":false,"schema":{"default":"desc","type":"string","enum":["asc","desc"]}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100},"description":"Page size, 1 to 100."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":512},"description":"Opaque cursor from meta.page.nextCursor."}],"responses":{"200":{"description":"Tokens","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Token"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/tokens/{address}":{"get":{"tags":["tokens"],"summary":"One token with all score windows, smart wallets buying and copycat original","parameters":[{"name":"address","in":"path","required":true,"description":"0x address, any case.","schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}}],"responses":{"200":{"description":"Token","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Token"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/tokens/{address}/trades":{"get":{"tags":["tokens"],"summary":"Trades, newest first","parameters":[{"name":"address","in":"path","required":true,"description":"0x address, any case.","schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100},"description":"Page size, 1 to 100."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":512},"description":"Opaque cursor from meta.page.nextCursor."},{"name":"side","in":"query","required":false,"schema":{"type":"string","enum":["buy","sell"]}}],"responses":{"200":{"description":"Trades","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Trade"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/tokens/{address}/score":{"get":{"tags":["tokens"],"summary":"Organic score with per-metric breakdown and clusters","parameters":[{"name":"address","in":"path","required":true,"description":"0x address, any case.","schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}},{"name":"window","in":"query","required":false,"schema":{"type":"string","enum":["launch","1h","24h"]}}],"responses":{"200":{"description":"Score","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","properties":{"token":{"type":"string"},"disclaimer":{"type":"string"},"windows":{"type":"array","items":{"$ref":"#/components/schemas/Score"}}}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/tokens/{address}/holders":{"get":{"tags":["tokens"],"summary":"Top holders. Pool, locker and burn are marked as excluded from top-10 %","parameters":[{"name":"address","in":"path","required":true,"description":"0x address, any case.","schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"Holders","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/tokens/{address}/candles":{"get":{"tags":["tokens"],"summary":"OHLC candles in ETH from indexed trades","parameters":[{"name":"address","in":"path","required":true,"description":"0x address, any case.","schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}},{"name":"interval","in":"query","required":false,"schema":{"default":"5m","type":"string","enum":["1m","5m","1h"]}},{"name":"limit","in":"query","required":false,"schema":{"default":300,"type":"integer","minimum":1,"maximum":500}}],"responses":{"200":{"description":"Candles","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/deployers/{address}":{"get":{"tags":["profiles"],"summary":"All launches by a deployer, graduation rate, average score, quick-sell and bundle patterns","parameters":[{"name":"address","in":"path","required":true,"description":"0x address, any case.","schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}}],"responses":{"200":{"description":"Deployer","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/wallets/{address}":{"get":{"tags":["profiles"],"summary":"A wallet's pons trades, positions, realized PnL and smart label","parameters":[{"name":"address","in":"path","required":true,"description":"0x address, any case.","schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100},"description":"Page size, 1 to 100."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":512},"description":"Opaque cursor from meta.page.nextCursor."}],"responses":{"200":{"description":"Wallet","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/webhooks":{"get":{"tags":["webhooks"],"summary":"List your webhooks","responses":{"200":{"description":"Webhooks","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Webhook"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["webhooks"],"summary":"Register a webhook. The response includes the signing secret.","description":"Deliveries are POSTed as JSON with header x-debundle-signature: t=<unix>,v1=<hex HMAC-SHA256 of '<t>.<raw body>' with your secret>. Failed deliveries retry after 1m, 5m, 30m, 2h and 12h. URLs must be public https.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri"},"events":{"minItems":1,"type":"array","items":{"type":"string","enum":["token.launched","token.hot","token.graduated","token.score_changed"]}}},"required":["url","events"]}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Webhook"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/webhooks/{id}":{"delete":{"tags":["webhooks"],"summary":"Delete a webhook","parameters":[{"name":"id","in":"path","required":true,"description":"Webhook id.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Authorization: Bearer psk_live_…"},"apiKey":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"Meta":{"type":"object","properties":{"indexedBlock":{"type":["string","null"]},"indexedAt":{"type":["string","null"]},"lagSeconds":{"type":["number","null"]},"scoreVersion":{"type":"number"},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]},"limit":{"type":"number"}},"required":["nextCursor","limit"],"additionalProperties":false}},"required":["indexedBlock","indexedAt","lagSeconds","scoreVersion"],"additionalProperties":false},"Token":{"type":"object","properties":{"address":{"type":"string"},"version":{"type":"string","enum":["v1","v2"]},"name":{"type":["string","null"]},"symbol":{"type":["string","null"]},"logo":{"type":["string","null"]},"deployer":{"type":"string"},"pool":{"type":["string","null"]},"curve":{"type":["string","null"]},"pairToken":{"type":"string"},"launchedAt":{"type":"string","description":"ISO 8601."},"launchBlock":{"type":"string"},"launchTx":{"type":"string"},"ageMinutes":{"type":"number"},"priceEth":{"type":["number","null"]},"priceUsd":{"type":["number","null"]},"mcapUsd":{"type":["number","null"]},"fdvUsd":{"type":["number","null"]},"liquidityUsd":{"type":["number","null"]},"volume24hUsd":{"type":["number","null"]},"organicVolume1hUsd":{"type":["number","null"]},"organicVolume24hUsd":{"type":["number","null"]},"organicScore":{"type":["number","null"]},"organicLabel":{"anyOf":[{"type":"string","enum":["organic","mixed","bundled","insufficient_data"]},{"type":"null"}]},"buyersUnique":{"type":["number","null"]},"entitiesUnique":{"type":["number","null"]},"holderCount":{"type":["number","null"]},"top10HolderPct":{"type":["number","null"]},"devHoldingPct":{"type":["number","null"]},"devSold":{"type":["boolean","null"]},"graduated":{"type":"boolean"},"graduationProgress":{"type":["number","null"]},"creatorTaxBps":{"type":["number","null"]},"copycatOf":{"type":["string","null"]},"links":{"type":"object","properties":{"pons":{"type":"string"},"explorer":{"type":"string"}},"required":["pons","explorer"],"additionalProperties":false}},"required":["address","version","name","symbol","logo","deployer","pool","curve","pairToken","launchedAt","launchBlock","launchTx","ageMinutes","priceEth","priceUsd","mcapUsd","fdvUsd","liquidityUsd","volume24hUsd","organicVolume1hUsd","organicVolume24hUsd","organicScore","organicLabel","buyersUnique","entitiesUnique","holderCount","top10HolderPct","devHoldingPct","devSold","graduated","graduationProgress","creatorTaxBps","copycatOf","links"],"additionalProperties":false},"Trade":{"type":"object","properties":{"txHash":{"type":"string"},"logIndex":{"type":"number"},"venue":{"type":"string","enum":["v1_pool","v2_curve","v2_pool"]},"side":{"type":"string","enum":["buy","sell"]},"trader":{"type":"string"},"recipient":{"type":["string","null"]},"quoteAmount":{"type":"string","description":"Wei string in the pair token's decimals."},"tokenAmount":{"type":"string","description":"Wei string."},"quoteEth":{"type":"number"},"valueUsd":{"type":["number","null"]},"priceEth":{"type":["number","null"]},"block":{"type":"string"},"timestamp":{"type":"string"},"viaContract":{"type":"boolean"}},"required":["txHash","logIndex","venue","side","trader","recipient","quoteAmount","tokenAmount","quoteEth","valueUsd","priceEth","block","timestamp","viaContract"],"additionalProperties":false},"Score":{"type":"object","properties":{"window":{"type":"string","enum":["launch","1h","24h"]},"scoreVersion":{"type":"number"},"score":{"type":["number","null"]},"label":{"type":"string","enum":["organic","mixed","bundled","insufficient_data"]},"metrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"value":{"type":"number"},"weight":{"type":"number"},"penalty":{"type":"number"}},"required":["value","weight","penalty"],"additionalProperties":false}},"clusters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"wallets":{"type":"array","items":{"type":"string"}},"funders":{"type":"array","items":{"type":"string"}},"buyVolumeEth":{"type":"number"},"totalVolumeEth":{"type":"number"},"flags":{"type":"array","items":{"type":"string"}}},"required":["id","wallets","funders","buyVolumeEth","totalVolumeEth","flags"],"additionalProperties":false}},"organicVolumeEth":{"type":"number"},"totalVolumeEth":{"type":"number"},"computedAt":{"type":"string"}},"required":["window","scoreVersion","score","label","metrics","clusters","organicVolumeEth","totalVolumeEth","computedAt"],"additionalProperties":false},"Webhook":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string","enum":["token.launched","token.hot","token.graduated","token.score_changed"]}},"active":{"type":"boolean"},"createdAt":{"type":"string"},"secret":{"type":"string","description":"Only on create."}}},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}},"responses":{"BadRequest":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorized":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Not indexed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Rate limit exceeded (free 60/min, pro 600/min)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}