docs: drop 6 sunset endpoints, correct ~140 stale prices, add DefiLlama + Market Data - #33
Merged
Merged
Conversation
…ma + Market Data
Follows the blockrun-side audit of the published endpoint surface.
Removed — upstream probing (3 runs each, 2026-08-04) showed these are gone:
/v1/pm/markets, /v1/pm/markets/listings, /v1/pm/outcomes/{predexon_id}
410 "sunset as of 2026-07-20. Market matching is discontinued." The #32 note
named these as the replacement for matching-markets; they were already dead
when it was written. markets/search is the survivor, and examples now use it.
/v1/pm/dflow/*
404 route-not-found. The dFlow category is gone from Predexon v2.
/api/v1/markets/* (ecosystem table)
Never existed as a route at all — a phantom row.
/v1/pm/sports/* is marked temporarily unavailable rather than deleted: it is
returning a consistent upstream 500, which is a partner bug, not a sunset.
Prices: every per-call figure in these docs was the customer price under the
OLD $0.002 transaction fee. It returned to $0.001 on 2026-07-29 and the docs
never moved, so all of them over-quoted:
Predexon / Surf 0.0095 -> 0.0085 (117 occurrences)
Exa flat 0.012 -> 0.011 · contents 0.002 -> 0.003 / URL
Modal create 0.012 -> 0.011 · ops 0.003 -> 0.002
RPC 0.004 -> 0.003
Solana RPC 0.0025 -> 0.0015
Sound effects 0.052 -> 0.0535
Music 0.15 -> 0.151 · Live search 0.025 -> 0.026 / source
Voice call 0.542 -> 0.541 · phone number 5.00 -> 5.001
RealFace / Portrait / Polymarket-fund 0.012 -> 0.011
Equities (Pyth) 0.003 -> 0.0010
The last one was not fee drift: pyth-handler.ts bills PYTH_PRICE_USD flat and
deliberately does not add the transaction fee, so the docs were 3x high.
New pages, both for services that were live with no documentation anywhere:
api-reference/defillama.md — 5 endpoints, TVL / yields / token prices
api-reference/market-data.md — the Pyth verticals, incl. which are free
x402/endpoints.md gains a DeFi Data section and per-endpoint phone pricing in
place of "returned in 402"; ecosystem.md gains the seven services it omitted.
This was referenced Aug 4, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Follows an audit of BlockRun's published endpoint surface (blockrun#chore/endpoint-surface-sync).
Removed — upstream probing showed these are gone
Probed
api.predexon.comdirectly, 3 runs each, 2026-08-04:/v1/pm/markets,/v1/pm/markets/listings,/v1/pm/outcomes/{predexon_id}— all return410 "This endpoint has been sunset as of 2026-07-20. Market matching is discontinued."The docs(pm): drop sunset matching-markets endpoints #32 note named these as the replacement for
matching-markets; they were already deadwhen it was written.
markets/searchis the survivor (422 on a missing?q=, i.e. alive),and every example now uses it.
/v1/pm/dflow/*— bare{"detail":"Not Found"}, upstream's no-such-route body. The dFlowcategory is gone from Predexon v2.
/api/v1/markets/*in the ecosystem table — never existed as a route at all./v1/pm/sports/*is marked temporarily unavailable rather than deleted: it returns aconsistent upstream
500, which is a partner bug, not a sunset.Prices
Every per-call figure in these docs was the customer price under the old $0.002 transaction
fee. It returned to $0.001 on 2026-07-29 and the docs never moved, so all of them over-quoted:
The last one is not fee drift:
pyth-handler.tsbillsPYTH_PRICE_USDflat and deliberatelydoes not add the transaction fee, so the docs were 3x high.
New pages
Both for services that were live with no documentation anywhere:
api-reference/defillama.md— 5 endpoints (TVL, per-chain TVL, yields, token prices)api-reference/market-data.md— the Pyth verticals, including which are freex402/endpoints.mdgains a DeFi Data section and per-endpoint phone pricing in place of"returned in 402";
ecosystem.mdgains the seven services it omitted.