Public API Access

Pharos API

Request a self-serve key for read-only public stablecoin data. The default key is scoped to external API traffic, limited to 30 requests per minute, and expires after 60 days.

API Reference OpenAPI Postman

Call Pattern

Base URL: https://api.pharos.watch

Header: X-API-Key

Respect 429 responses and add jitter to polling intervals.

Email Verified

A verification link is sent before a key is issued. The API token is revealed once in the browser after verification.

External Lane

Use the public API host directly for integrations. Browser pages on Pharos use a separate site-data lane.

Reference Ready

Endpoint contracts, OpenAPI, and Postman artifacts stay on the reference page for implementation work.

Start with a read endpoint

Use the external API lane for integrations, CI jobs, notebooks, and partner dashboards. The website uses a separate same-origin site-data lane, so browser code copied from Pharos pages is not the right integration contract.

GET

/api/stablecoins

Stablecoin market snapshot

Supply, price, chains, peg metadata, and freshness headers for every tracked active stablecoin.

GET

/api/stablecoin/usdc-circle

Single stablecoin detail

Per-coin profile for dashboards that need one canonical ID at a time.

GET

/api/depeg-events?active=true

Active peg incidents

Current depeg events and incident history filters for monitoring workflows.

GET

/api/dex-liquidity

DEX liquidity scores

Pool depth, protocol diversity, and exit-capacity data keyed by Pharos stablecoin ID.

Working Examples

Call Pharos from your stack

curl

curl https://api.pharos.watch/api/stablecoins \
  -H "X-API-Key: $PHAROS_API_KEY"

JavaScript

const response = await fetch("https://api.pharos.watch/api/stablecoin/usdc-circle", {
  headers: { "X-API-Key": process.env.PHAROS_API_KEY },
});

if (!response.ok) throw new Error(`Pharos API returned ${response.status}`);
const coin = await response.json();

Python

import os
import requests

response = requests.get(
    "https://api.pharos.watch/api/depeg-events",
    params={"active": "true"},
    headers={"X-API-Key": os.environ["PHAROS_API_KEY"]},
    timeout=10,
)
response.raise_for_status()
events = response.json()