Pharos API

Safety Score grades for every tracked stablecoin are free and need no key. The full read-only API is keyed: keys are scoped to external API traffic and carry a per-key rate limit and expiry.

API Reference OpenAPI Postman

Free Grades

Safety Score grades for every tracked stablecoin are served without an API key. Everything else on the public host needs one.

External Lane

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

Supporter Key

Wallets with at least $10 in donations of stablecoins currently graded A or B (including +/−) can claim one key at 10 requests per minute, with no scheduled expiry.

Call Pattern

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

Header: X-API-Key

Respect 429 responses and add jitter to polling intervals.

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()

No API Key Required

Safety Score grades for every stablecoin

One score and grade per tracked stablecoin from the current published Safety Score, with the methodology version and publication status. Same publication as the keyed report cards, refreshed on the same schedule. Coin IDs use the Pharos ticker-issuer form.

curl

curl https://api.pharos.watch/api/safety-grades

Supporter Key

A thank-you perk for donors

Any externally-owned EVM wallet with at least $10 in qualifying stablecoin donations in the public donation ledger can claim one API key. The wallet proves it is yours by signing a short text message: no transaction, no email address, and no payment processor.

10 requests per minute, no scheduled expiry, revocable, and no SLA.
Only donations of stablecoins currently graded A+, A, A−, B+, B, or B− count at claim time. Later grade changes do not revoke an issued key.
Claims pause while the current Safety Score publication is held or unavailable.
One key per wallet. A lost key is rotated by hand through the feedback form.
The donating wallet has to be able to sign: exchange withdrawals and contract wallets do not qualify.
Claims are not instant. The donor list is updated once a week, on Sunday mornings; a new donation can only be claimed once it appears on the funding page. Ledger last reconciled 2026-09-20 UTC.

Sign only on pharos.watch. If the wallet warns that the requesting site does not match pharos.watch, reject the request: a signed claim can be redeemed by whoever holds it first.

Keyed Access

Self-serve key issuance is closed

New keys are not issued on demand while a paid API tier is being prepared. Keys already issued keep working until their expiry date.

If you need keyed access for a project in the meantime, describe it through the feedback form and it will be reviewed by hand.

Integrations that deliver a freely available, non-profit service on top of Pharos data - FrankenCoin and Octav are examples - receive keys at no cost on request through the same form.

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()