# pricemon

> Open, real-time Bitcoin (BTC) price aggregator. pricemon subscribes to public
> WebSocket trade feeds from major crypto exchanges (Kraken, Bitfinex, Binance,
> and others), computes volume-weighted (VWAP) prices per minute, and merges
> stablecoin-quoted volume (USDT, USDC) into USD/EUR using same-window peg
> rates. Prices are available in USD, EUR, and ~120 other fiat currencies
> (long-tail fiats anchored to live BTC/USD via reference rate snapshots).

## How to get a price

All endpoints return JSON, need no authentication, and allow any origin (CORS).
Substitute a currency code (USD, EUR, GBP, NGN, …) for `{code}`.

- [Live BTC price, all fiats](https://price.cheeserobot.org/api/v1/current/): sub-minute cross-exchange VWAP. Fields: `weighted_fiat[].price`.
- [Live BTC price in one currency](https://price.cheeserobot.org/api/v1/current/?extended_fiats=NGN): read `extended_fiats[0].price`. Works for every listed currency.
- [Window VWAP](https://price.cheeserobot.org/api/v1/prices/?quote=USD&window=5): volume-weighted price over the last N minutes.
- [Compact summary](https://price.cheeserobot.org/price/summary.json): `{price: {price_usd, price_eur}, hist_1d, hist_7d, latest_block}`. Add `?currency=GBP,JPY` for other fiats.
- [Currency catalog](https://price.cheeserobot.org/api/v1/currencies/): every code the API can price BTC in, each with the exact follow-up call to make.

## History (OHLC candles)

- [Per-minute candles](https://price.cheeserobot.org/api/v1/candles/?base=BTC&fiat=USD&window=120): recent OHLC.
- [Resampled candles](https://price.cheeserobot.org/api/v1/candles/agg/?base=BTC&fiat=USD&window=10080&interval=60): multi-day OHLC at any bucket size (up to 1 year).

## Docs

- [OpenAPI 3 schema](https://price.cheeserobot.org/api/v1/schema/): full machine-readable API spec.
- [Swagger UI](https://price.cheeserobot.org/api/v1/docs/) and [ReDoc](https://price.cheeserobot.org/api/v1/redoc/): interactive docs.
- [Health](https://price.cheeserobot.org/api/v1/health/): liveness + latest aggregated minute.

## Pages

- [Live overview](https://price.cheeserobot.org/): dashboard with per-exchange breakdown and candle charts.
- [History](https://price.cheeserobot.org/history/): per-minute chart and table (params: `base`, `fiat`, `window`).

## Notes

- Base asset is BTC. Quote currencies: USD and EUR are trade-native; others are derived (BTC/USD x reference fiat rate) and marked `pricing: "derived"`.
- Timestamps are ISO 8601 UTC; candle `time` fields are Unix epoch seconds.
- Data is informational, aggregated from public trades; not investment advice.
- Source: https://github.com/AbelLykens/pricemon