# NEWSFEED

Peg integrity for USD stablecoins.

A stablecoin claims to be worth exactly $1.00. Several exchanges price it at
slightly different numbers. NEWSFEED reads every coin from up to 7 independent
public venues (coinbase, kraken, gemini, bitstamp, bitfinex, binance.us, crypto.com), takes the median of the ones
that agree, and publishes both the deviation from the peg AND how far the venues disagreed.

## Endpoints

GET https://newsfeed.space/v1/depegs        only coins genuinely off peg, with the error bar
GET https://newsfeed.space/v1/peg           every coin, including the readings that were withheld
GET https://newsfeed.space/v1/peg/USDT      one coin, every venue, and which were set aside
GET https://newsfeed.space/v1/venues        how each price source is behaving
GET https://newsfeed.space/v1/health        which venues answered on the last sweep
GET https://newsfeed.space/v1/access        the tiers, and how many have asked for full access
POST https://newsfeed.space/v1/access       request full access: {"via":"x"|"github","handle":"..."}

CORS is open. Venues are swept every 60s.

## Tiers

Without a key you are on the PREVIEW tier. It exists to prove the instrument
works, not to be the product:

  in full        USDT, USDC, DAI, PYUSD — price, deviation, error bar, every quote
  verdict only   the other eight — "significant" and venueCount survive; price,
                 deviationPct, uncertaintyPct, quotes and outliers are withheld
                 and the reading carries locked: true

Every response says which tier served it in the "access" field.

FULL access adds the withheld numbers on every coin. Request it with an X or
GitHub handle (POST /v1/access, or the form on the site); a key is sent back on
that platform and used as  Authorization: Bearer <key>.

## The one thing to understand before using this

Most "depeg" alerts are bad quotes, not depegs.

A thin or stale order book on one venue will happily print $0.95 for a coin that
three other venues agree is at $1.00. NEWSFEED takes the median of the agreeing
venues, names the disagreeing ones in "outliers", and refuses to report a
deviation smaller than the venues' own spread.

  deviationPct    how far the consensus price is from $1.00
  uncertaintyPct  half the spread of the venues that agreed
  significant     true only when |deviationPct| exceeds uncertaintyPct

If you act on deviationPct without reading uncertaintyPct, you will act on noise.

A coin priced by a single venue has NO uncertainty figure, because one quote
cannot be corroborated. Treat those readings as unverified.

## Not measured

Non-USD stablecoins. A euro-pegged coin measured against a dollar reads as a
permanent 15% depeg, which is a units error, not a finding.

## What this is not

Not financial advice, not a solvency or reserves assessment. This measures
market price against a claimed peg. A coin can hold its peg perfectly and still
be backed by nothing.