poolproof API

Four checks. Facts only, no advice. Overview · OpenAPI · llms.txt

Machine-readable spec at /openapi.json (OpenAPI 3.1). Most agent frameworks will turn that straight into a callable tool. Payment terms at /.well-known/x402.

Endpoints

/v1/pool$0.015

Is this yield pool what it claims to be?

Param	Meaning
`pool`	DefiLlama pool id, from `yields.llama.fi/pools`

Prices every underlying asset against its peg, compares APY to its own history, reports whether the yield survives once emissions stop, and checks exit depth.

curl "https://poolproof.ru/free/pool?pool=<uuid>"

Flags: DEPEG OPAQUE SPIKE UNSTABLE EMISSION THIN

/v1/exit-cost$0.030

What does leaving this Solana position actually cost, at your size?

Param	Meaning
`mint`	Solana token mint address
`size`	Position size in whole tokens. The whole point is that the quote is for your size.

Quotes your real size against a live router, then compares it to the price at negligible size. The difference is what leaving actually costs.

curl "https://poolproof.ru/free/exit-cost?mint=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&size=50000000"

Flags: SIZE_WALL EXIT_COST

/v1/chain$0.009

Is this chain alive, or has the capital left?

Param	Meaning
`chain`	Chain name as DefiLlama spells it

curl "https://poolproof.ru/free/chain?chain=Bitlayer"

Flags: COLLAPSED STILL_FALLING TINY

/v1/launch$0.015

Who launched this pump.fun token, and what became of their previous ones?

Param	Meaning
`mint`	Solana mint address of the pump.fun token

Returns how many tokens the same creator wallet has launched, how many of them reached the exchange, the graduation rate of that creator group against the overall base rate, and a flag when the creator filled the bonding curve with their own purchase — in which case reaching the exchange reflects their buy, not demand. Price, volume and liquidity are public everywhere; that a token is the 238th from a wallet whose tokens have never survived is not.

Built from our own recording of every pump.fun launch and its author since 10 August 2026. A wallet active before that date appears unseen, and the response says so rather than calling it new. Empty flags mean nothing failed these particular checks, not that the launch is safe.

curl "https://poolproof.ru/free/launch?mint=<mint>"

/v1/known$0.060

Do we hold a research note on this that no data feed reports?

Param	Meaning
`q`	Asset symbol, protocol name, chain name or contract address

44 notes covering dead redemption bridges, tickers shared by unrelated projects, points programmes that ended quietly, marketplaces that shut down, roles whose real capital gate appears in no documentation, and measurement failures that make a losing system look profitable.

curl "https://poolproof.ru/free/known?q=renBTC"

Verdicts: unredeemable ticker_collision stale_data token_issued programme_ended shut_down gated no_edge leak bug method hft_only exhausted

An empty result means we have not investigated it. It is not a clean bill of health.

/v1/launches$0.030

What is launching on pump.fun right now, and who is behind it?

Param	Meaning
`since`	Unix timestamp; return only launches after it (poll incrementally)
`limit`	How many, newest first (1-200, default 50)
`only`	first_time \| serial \| bought_curve \| graduated \| clean

A live feed of the last 24h of pump.fun launches, each carrying its creator's record. This history cannot be reconstructed afterwards.

curl "https://poolproof.ru/free/launches?limit=5"

/v1/stable$0.030

Is a stablecoin's $1 peg a hard anchor or a soft peg?

Param	Meaning
`asset`	Stablecoin symbol (e.g. USDC) or CoinGecko id

Ninety days of history decide whether the price returns to $1 (a hard redemption/arbitrage anchor) or sits below it (the market pricing risk, not a dislocation to arbitrage), plus whether a historically sound peg is off right now.

curl "https://poolproof.ru/free/stable?asset=USDC"

Verdicts: SOUND_ANCHOR SOFT_PEG UNKNOWN. Flags: SOFT_PEG BROKEN_HISTORY DISLOCATION

/v1/safety$0.030

Is this Solana token safe to touch?

Param	Meaning
`mint`	Solana token mint address

Mint and freeze authority (can they print more, can they freeze your account and block the sale), top-holder concentration and Token-2022 transfer risks — fused with the deployer's full launch record from our own recording. A serial minter with no survivors is a flag no plain rug-checker carries.

curl "https://poolproof.ru/free/safety?mint=<mint>"

Flags: MINT_AUTHORITY_LIVE FREEZE_AUTHORITY_LIVE CONCENTRATED TOKEN_2022 SERIAL_DEPLOYER DEPLOYER_NEVER_GRADUATED

/v1/deployer$0.030

What is this wallet's track record as a token deployer?

Param	Meaning
`wallet`	Solana wallet address of the deployer

Every launch we recorded from this wallet: how many tokens, how many reached the exchange, its graduation rate against our measured base rates, and whether it is a serial minter with no survivors. This history cannot be reconstructed after the fact.

curl "https://poolproof.ru/free/deployer?wallet=<address>"

Verdicts: SEEN SERIAL_MINTER SERIAL_NO_GRADUATES UNOBSERVED. Flags: serial_minter never_graduated

Free tier

Swap /v1/ for /free/. No key, no signup, ten calls an hour per address. Same answers, so you can decide whether it's worth paying before you pay.

Paying

Call a /v1/ path with no payment and you get 402 with the terms in the body:

{
  "x402Version": 1,
  "accepts": [{
    "scheme": "exact",
    "network": "base",
    "maxAmountRequired": "5000",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0x11Efa031D56316bD63720d172f9d5c1448e9a21F"
  }]
}

Sign the authorisation, base64 it into an X-PAYMENT header, repeat the request. Any x402 client library does this for you. Settlement is USDC on Base and takes about a second.

Reading the response

Every response carries a flags array. Empty means nothing failed. Each flag has a code you can branch on and a msg for humans. Nothing is scored or ranked, because the decision isn't ours to make.

What we record — live counts behind /v1/launch.