API References

The data behind every page.

These are the same REST endpoints that power pyrefi.com — token directory, AI indicators, trading signals, market data, and news.

Base URL

https://api.pyrefi.com/api/v1

Authentication

Read endpoints listed below are public — no API key required. Endpoints that read or write account-specific data (watchlists, trading config, billing) require the signed-in session used by the web app and aren't intended for third-party access yet. A dedicated API key program for funds, quants and institutional desks is on the roadmap — see the changelog for updates.

Token directory

GET

/tokens

Paginated token list with live price and market data.

GET

/tokens/directory

Directory feed with AI indicators — sortable and filterable.

GET

/tokens/:slug

Full token detail — price, metadata, links.

GET

/tokens/:slug/indicators

Current Conviction, Pulse, Structure, Ignition & Risk Lens scores.

GET

/tokens/:slug/ohlcv

Candlestick OHLCV history for charting.

GET

/tokens/:slug/news

News articles mentioning this token.

GET

/tokens/trending

Tokens trending by conviction score.

Trading signals

GET

/signals

Active trading signals — entry, target, stop-loss, confidence.

GET

/signals/:id

Single signal detail.

GET

/signals/stats

Aggregate win-rate and performance stats.

GET

/signals/token/:slug

Signal history for a specific token.

Market data

GET

/market/global

Global market cap, 24h volume, BTC/ETH dominance, Fear & Greed.

GET

/market/pulse

Long/short ratio, funding rate, open interest.

GET

/market/sectors-weekly

Sector rotation performance over the trailing week.

News

GET

/news/latest

Latest AI-tagged news articles, filterable by sentiment.

GET

/news/digest

AI-generated daily news summary.

GET

/news/trending