Pharos

Pharos API

Stablecoin analytics API for peg monitoring, liquidity, risk, blacklist events, mint/burn flows, yield, chains, and market-structure data. Protected public…

Finance & banking#cryptocurrency

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Stablecoin analytics API for peg monitoring, liquidity, risk, blacklist events, mint/burn flows, yield, chains, and market-structure data. Protected public routes require X-API-Key. Get a supporter key or request a partner key at https://pharos.watch/api/.

Endpoints 42

Health

  • GETHealth check/api/healthNo-key availability canary for the public API host; it is not the operator status dashboard. Since 2026-09-27 dedicated asset-scoped circuit outages no longer…

Stablecoins

  • GETList stablecoins/api/stablecoinsCurrent stablecoin list with supply, price, same-observation current peg deviation/trust, chain distribution, FX context, and freshness headers. _meta…
  • GETStablecoin detail/api/stablecoin/:stablecoinIdFull current/historical per-coin analytics dossier for a canonical Pharos stablecoin ID. Nominal references follow the pricing v6.38 contract; optional…
  • GETStablecoin summary/api/stablecoin-summary/:stablecoinIdLightweight per-coin price and aggregate supply snapshot. Nominal references follow the pricing v6.38 contract; optional priceDerivation accompanies only an…
  • GETStablecoin reserves/api/stablecoin-reserves/:stablecoinIdLive or fallback reserve composition and reviewed provenance for live-reserve-enabled assets. Since 2026-09-27 the freshness verdict carries its policy…
  • GETStablecoin charts/api/stablecoin-chartsHistorical total supply chart data.

Peg Monitoring

  • GETPeg summary/api/peg-summaryPer-coin peg scores, reference evidence, coverage-aware recent metrics, and aggregate peg-monitoring summary. Since v6.31, unknownCoverageSeconds excludes…
  • GETDepeg incidents/api/depeg-eventsHistorical and active depeg incidents with constituent threshold-crossing counts, filterable by asset, state, and review verdict. total counts every pageable…

Liquidity

  • GETDEX liquidity/api/dex-liquidityDEX liquidity scores, top pools, chain/protocol breakdowns, and quality metadata. Volume, activity and NR follow the liquidity v6.9 volume contract. Empty…
  • GETDEX liquidity history/api/dex-liquidity-history?stablecoin=stringBounded historical liquidity-score data for a stablecoin. volume24h and score follow the liquidity v6.9 volume contract.

Risk

  • GETTape events/api/eventsMaterialized chronological feed of typed events (depeg, freeze, score) backed by the tape_events table. Supports filtering by type, coin, severity floor, and…
  • GETUSDS freeze status/api/usds-statusSky/USDS protocol status, including whether the freeze module is currently active.
  • GETBluechip ratings/api/bluechip-ratingsSafety ratings from bluechip.org joined to Pharos identities for covered stablecoins.
  • GETSafety Score V9 report cards/api/report-cards/v9Canonical API schema-8 Safety Score report cards from the accepted internal schema-7 publication. Public cards carry resolved witness text without card-local…
  • GETSafety Score grades (no key)/api/safety-gradesFree schema-1, no-key projection of the accepted V9 publication: nullable score/grade, ratingStatus and compact partialEvidence per tracked stablecoin, plus…
  • GETDependency graph (no key)/api/dependency-graph/v1Free schema-2 projection of the accepted V9 publication: publication-bound node supply, nullable grades, ratingStatus, compact partialEvidence, role summaries…
  • GETModeled dependency scenarios (no key)/api/dependency-scenarios/v1Offline schema-2 production-evaluator scenarios from a V9 publication, refreshed daily. Published and modeled rows preserve ratingStatus, compact…
  • GETDepeg Duration Resolver/api/depeg-resolverPer active confirmed depeg: a mechanistic resolution outlook (terminal vs recoverable) and a stratified empirical duration estimate with per-horizon…
  • GETDepeg Duration Resolver Reviewer/api/depeg-resolver-reviewReview of stored DDR predictions against later depeg-event outcomes, including recovery-likelihood accuracy and observed-minus-predicted recovery duration…
  • GETRedemption backstops/api/redemption-backstopsModeled issuer/protocol redemption routes and effective-exit scoring for configured assets.
  • GETStress signals/api/stress-signalsDEWS-style stress signals for the stablecoin universe or one selected asset. Each current row publishes assessedAt, freshBudgetSec, degradedBudgetSec and…
  • GETPharos Stability Index/api/stability-indexPSI and history. Daily components preserve null versus observed zero; partial averages disclose dailyProvenance.componentSampleCounts. All-day averaging and…
  • GETSafety score history/api/safety-score-history?stablecoin=stringLegacy bounded long-range safety-score history for a stablecoin.
  • GETSafety score history (identity-aware)/api/safety-score-history-v2?stablecoin=stringBoundary-aware safety-score history with full score-model identity and transition kinds; the legacy endpoint remains the V8 compatibility projection.

Blacklist

  • GETBlacklist events/api/blacklistNormalized issuer freeze, unfreeze, blacklist, and destruction events with optional uppercase symbol, chain display-name or chain ID, event type, search,…
  • GETBlacklist summary/api/blacklist-summaryBlacklist summary statistics, chart data, chain options, manifest-derived coverage metadata, and freeze-ledger data-quality context. Prefer tracked…

Flows

  • GETMint and burn flows/api/mint-burn-flowsMint/burn flow aggregates and pressure for closed UTC hours, with token-bound bridge exclusions and a dense hourly series: proven quiet hours are zero, while…
  • GETMint and burn events/api/mint-burn-events?stablecoin=stringNormalized issuance event stream for supported stablecoins with cursor or offset pagination. Since 2026-09-28 (mint-burn-flow v6.23) amountUsd is set only…

Yield

  • GETYield rankings/api/yield-rankingsYield-bearing stablecoin rankings with safety, benchmark-aware context, and optional publication/source-risk metadata fields. ?projection=summary returns the…
  • GETYield adapter manifest/api/yield-adapter-manifestMachine-readable source-list manifest for every yield-bearing asset, including adapter family, exact runtime source key when known, source-key pattern for…
  • GETYield history/api/yield-history?stablecoin=stringHistorical yield observations for a stablecoin, with optional publication/source-risk metadata fields.

Chains

  • GETChains/api/chainsChain-level stablecoin aggregates with Chain Health Scores; pass chain for full per-chain coin detail rows. _meta discloses assessment time and the route's…

Market Structure

  • GETNon-USD share/api/non-usd-shareCurrent and historical market share of tracked non-USD peg groups for market-structure views.

History

  • GETSupply history/api/supply-history?stablecoin=stringHistorical supply series for a stablecoin. Bounded days defaults to 365; range=all returns every retained daily observation under the same completed-snapshot…

Digest

  • GETDaily digest/api/daily-digestLatest AI-generated stablecoin market digest. With no eligible edition, all eleven response fields are explicitly null.
  • GETDigest archive/api/digest-archiveDaily and weekly digest archive. The default response is bounded to the latest 365 rows. Use history=all and follow pagination.nextCursor until null for…
  • GETDigest snapshot/api/digest-snapshot?date=stringBuild-time digest context snapshot for a specific digest date. An elapsed UTC day is archive data; an in-progress day omits blacklistSummary and uses the…
  • GETPublic snapshot index/api/snapshots/indexListing of available daily public snapshots with content hashes and methodology versions, newest first. Keyset-paginated: pass pagination.nextCursor as cursor…
  • GETPublic snapshot for a single day/api/snapshots/:date.jsonFull per-day public dataset snapshot (camelCase). Immutable artifact keyed by YYYY-MM-DD; served unchanged with identity, ETag, and public, immutable,…
  • GETPublic snapshot projection for a single coin/api/snapshot/:date/stablecoin/:stablecoinIdPer-coin slice of a daily snapshot (camelCase). Immutable artifact keyed by YYYY-MM-DD + stablecoin id; served with public, immutable, max-age=1y cache headers.

Status

  • GETPublic status history/api/public-status-historyBounded, public-safe status timeline for the Pharos system.
  • GETTelegram pulse/api/telegram-pulseLightweight public Telegram adoption and delivery-health aggregates.

API details

Base URL
https://api.pharos.watch
Authentication
An API key in the X-API-Key header
Operations
42 operations on 42 pathsGET 42
Main resources
Risk 14History 9Digest 6Stablecoins 6Peg Monitoring 5Yield 3Blacklist 2Flows 2Liquidity 2Reserves 2
Response formats
application/json
Description format
OpenAPI 3.1.0, API version 1.0.0

How to test the Pharos API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Pharos API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses an API key in the X-API-Key header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Health check” (GET /api/health), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Pharos API?

Stablecoin analytics API for peg monitoring, liquidity, risk, blacklist events, mint/burn flows, yield, chains, and market-structure data. Protected public… It is listed under Finance & banking and has 42 endpoints.

Who publishes the Pharos API?

It is listed from Pharos's public API description (an OpenAPI document), not published by Pharos on Swastik Codes. Anyone who controls pharos.watch can claim the profile by adding a DNS TXT record.

What is the base URL of the Pharos API?

Requests go to https://api.pharos.watch. Endpoint paths are added to this base URL.

How do I authenticate with the Pharos API?

With an API key in the X-API-Key header.

How many endpoints does the Pharos API have?

42 operations on 42 paths (42 GET). The largest groups are Risk, History, Digest, Stablecoins.

Is forking the Pharos API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.