{"name":"Spark API v1","notes":["Read-only. Amounts are wei (ETH) or base units (tokens, 18 decimals) as decimal strings. Shares are in basis points of the 1,000,000,000 supply.","Data is indexed from the chain about every minute, and a few seconds after any request when it is older than that.","Holders, top 10, dev, snipers and bundles leave out the launchpad, the LP locker, the pool (also before it exists), the dead address and 0x0.","Several launchpads: add ?pad={address} to any endpoint (default: the first in `launchpads`). A quoted launchpad prices tokens in its quote token instead of ETH (`quote` below): every \"wei\" amount is then in that token's base units (18 decimals)."],"endpoints":{"GET /v1":"this page, with the chain, the launchpad and the last indexed block","GET /v1/tokens?sort=new|active|mcap|volume&limit=50&offset=0":"tokens with prices and risk metrics","GET /v1/tokens/{address}":"one token","GET /v1/tokens/{address}/holders?limit=50":"largest holders; contracts are labelled and not counted in metrics","GET /v1/tokens/{address}/trades?limit=50&before={block}":"curve and pool trades, newest first","GET /v1/tokens/{address}/candles?tf=60|300|900|3600|14400|86400&limit=300":"OHLCV candles; prices in wei per whole token, volume in wei","GET /v1/tokens/{address}/quote?side=buy|sell&amount={wei or token base units}&slippageBps=100":"live quote from the chain, with the transaction to send","GET /v1/trades?limit=50":"latest trades of every token","GET /v1/all":"tokens and latest trades of every launchpad (every pair) in one answer","GET /v1/token/{address}":"one token by address, on whichever launchpad it is","GET /v1/pads":"every launchpad with its router, factory, quote token and whether the USDC zap trades it: what a bot or SDK needs to connect","GET /v1/keeper":"the vault keeper's last run: when, what it sent, errors, gas left (ok is false if it stopped)","GET /v1/contracts":"contract addresses, ABIs (human-readable, ethers/viem format) and how to trade"},"metrics":{"holders":"wallets holding more than zero","top10Bps":"share of the supply held by the 10 largest holders","devBps":"share held by the creator now","devStatus":"none (never bought) | holds | sold_part | sold_all; sold or moved away compared with what the creator bought","snipers":"wallets other than the creator that bought on the curve during the launch-fee window (snipeDuration after launch)","sniperBps":"share those wallets hold now","bundlers":"wallets other than the creator that bought in the same block as the launch (funding sources are not traced)","bundleBps":"share those wallets hold now"},"chainId":19529,"launchpad":"0x50b05de2ef605d6c1526957b274723c8817c8ad6","launchpads":["0x50b05de2ef605d6c1526957b274723c8817c8ad6","0x123eb4b81ffa644b960c5817920e81a7f063fa95","0x2f0b2dd7309950c32b3f21b6599ccb9f7796898f","0x1fffda25523d13a7b9f6bbbb462ca0f1cf4d5b88","0xbfb4d25722b6de0e31ac281c173c1fdaf4930344","0x219d135552a8422f2373dcb794abaecdbc9f8700","0x39aacdc6384910729982725012c481df3f202198","0xb0358339a9ee85d6e5768829f3a87b3ba5ecc058","0xcc2530e1e828966a8836aee857f418516c33baa5","0x43706b51fcd02698eab8350d1944eefb811ae1ef","0x01a81c5693b4a13499dda2edc1c80d327a68116d","0xf4bd7363002ca5a160bda415381ca8fa48243148","0xfca75bef4580b3a865075137838531f59102b418","0x1bea160244536da38a738746f9e1238b396df31a","0xc01f772851736d6f29763acabfb8d9a2a6ba53f6","0xd6d91dc6cb88d1aca2c83d5177635cbae4645a5e","0x3614e13f850f7abe7a0c2230c8666ef24178c3dc","0x9140018582114a82564f2f2c16b0221687ab16a0","0xd42c5548d87bfae0851310c9b597154860554193","0xda37226b129e101b3c7bc7c67d99cefb48b7c122","0x3f2c520c9ceb9732308d556fb75c420b3f219c7a","0x19d6787a8ddc29ab6d7c7d9d34feb48ad3436f14","0xef4b9f39dca8d7a592c9dc8e036f853451d463cf","0xab331dfe783ffc84df2e91887ef442b87327bd62","0xf308e6adea0d8e89af6e43ac2d2a4e8285d4cdff","0x2ebb3cf14c4110e7cddb38fbaa3b91467a36b7a2","0x674b64599172d354e07ccadf8d42916317a6d967","0xea9377d65a43fa164b0960d3617d67e4005db366","0x51dd804f9ceab47d46b3f4014f0229d38d97d35a"],"quote":{"token":"0x660000000000000000000000000000000000000c","symbol":"ETH","native":true},"indexedBlock":521602,"launch":{"defaults":{"vEth0":"1410000000000000000","vTok0":"1073000000000000000000000000","curveSupply":"793100000000000000000000000","feeBps":"100","gradFeeBps":"100","creatorShareBps":"3000","refShareBps":"1000","gradRewardBps":"5000","snipeFeeBps":"5000","snipeDuration":"60","maxCreatorBuyBps":"1000"},"creationFee":"2000000000000000","locker":"0xec67d81bddbc8630b8da0ea52d76de720514891f"}}