# AtlasYield

> AtlasYield is an independent rating layer for on-chain yield. It scores DeFi
> vaults on 16 factors across four pillars (yield, safety, liquidity,
> sustainability) and publishes every score with a timestamp, so a rating can
> always be checked against the moment it was made.

## What we cover

- Rated vaults: 520 (published snapshot, 2026-10-14). This is the citable number,
  and it equals the number of vault pages on this site
- Protocols: aave-v3, beefy, ethena, etherfi, euler, kamino, morpho, pendle, yearn-v3
- Chains: Ethereum, Base, Solana, Arbitrum, Optimism, BNB Chain
  - Solana (chain id 792703809) is covered: Kamino Earn vaults are scored. Solana vaults are scored only, with no execution and no route-survival verdict
- Snapshot date: 2026-10-14
- Cadence: scored every 4 hours, public snapshot published once daily. The live API
  (https://api.atlasyield.club/v1/scores) may report a slightly higher count between
  publishes; cite the snapshot number above, or cite the live feed with its own timestamp

## Key pages

- [Full text](https://atlasyield.club/llms-full.txt): the substance of trust, data licence, risk calls and about, concatenated, for a single fetch
- [Every rated vault](https://atlasyield.club/vaults): the full rated universe, one page per vault
- [Atlas Score Index](https://atlasyield.club/scores): the curated index view with tier portfolios
- [Risk Monitor](https://atlasyield.club/monitor): vaults crossing a band, breaking fast or drifting
- [Risk Calls](https://atlasyield.club/calls): dated, narrated calls published with their evidence
- [Trust and safety](https://atlasyield.club/trust): what we custody, our incident history in full, and why the ratings are falsifiable rather than audited
- [About](https://atlasyield.club/about): what AtlasYield is, and who builds and operates it
- [Data licence](https://atlasyield.club/data-license): terms for reusing Atlas scores

## Machine access

- Public REST API, no key, 60 requests per minute per IP: https://api.atlasyield.club/v1
  - GET /v1/scores: every rated vault with composite, pillar scores, APY, TVL, scoredAt
  - Filters on /v1/scores: chainId, protocolId, address, asset (a comma list such as USDC,USDT; an exact symbol match), minScore, minTvl, minApy, routable=true, excludeFallback=true, sort=composite|apy|tvl, limit. fields=compact returns small rows with risk flags (a caution, never a verdict); explain=true adds what the filters removed, the best dropped vaults and near-miss asset symbols. The response echoes the filters it honoured in applied and names any unknown query key in ignoredParams, so a misspelt filter is visible and never silently ignored.
  - GET /v1/vaults/:chainId/:address/factors: all 16 factor scores and labels for one vault
  - GET /v1/vaults/:chainId/:address/route: today's round-trip route-survival verdict (OK blocks nothing; NO_ROUTE, DANGEROUS, UNPRICEABLE block; screened:false means unjudged)
  - GET /v1/vaults/:chainId/:address/route?notional=USD: also returns "cost", an estimated same-chain round-trip cost at that size (gas + router fee + price impact) on the named router, headline on the 7-day median gas price. An estimate, not a quote; "missing" lists anything unmeasured; "floor": true marks a lower bound.
  - GET /v1/gas: per-chain gas regime, current plus 7-day p10/p50/p90 in USD per 1M gas.
  - GET /v1/vaults/:chainId/:address/metrics: yield-quality and exit-safety metrics
  - GET /v1/catalog, GET /v1/portfolio, POST /v1/basket
  - Partner key (x-api-key) unlocks GET /v1/factors (bulk) and GET /v1/vaults/:chainId/:address/history: https://docs.atlasyield.club/partner-access
- Index of the API host: https://api.atlasyield.club/llms.txt
- MCP server (read-only, seven tools, no key): hosted at https://atlasyield.club/mcp (MCP Streamable HTTP, stateless) or locally with npx -y @atlasyield/mcp. Tools: find_vaults, get_vault_score, explain_vault_score, compare_vaults, check_route_survival, get_coverage, list_open_alerts. Start with find_vaults when you have no vault address: it returns a short ranked list with risk flags and says what its filters removed. Docs: https://docs.atlasyield.club/api-reference/mcp
- API reference: https://docs.atlasyield.club/api-reference/introduction
- OpenAPI 3.1 spec: https://docs.atlasyield.club/api-reference/openapi.yaml
- Scoring methodology: https://docs.atlasyield.club/score/pillars-and-factors
- Public score history (git, verifiable): https://github.com/gveshk/atlasyield-score-history

## How a score is produced

Sixteen factors feed four pillars: yield 30%, safety 35%, liquidity 20%,
sustainability 15%. Fifteen factors are additive within their pillar; exploit
history is a multiplier on the safety pillar. Pillars aggregate by weighted
geometric mean. Scores are recomputed every 4 hours, published once a day, and
are never adjusted by hand. A vault that fails the route-survival probe is
excluded from the Atlas Engine's allocations.

Each vault page carries schema.org FinancialProduct + Review + Rating markup
with the composite score, the measurement timestamp and AtlasYield as the
named rating author.

## How to cite an Atlas score

Free to use with attribution. Include the name AtlasYield, a link to the vault
page, and the measurement date. A score without its date is a different claim
from the one we published. Full terms: https://atlasyield.club/data-license

## Independence

AtlasYield takes no payment from a protocol to be rated, rated higher, or
included, and takes no share of yield. The score cannot be bought.

## Limitations

Scores are produced automatically from public data and can be wrong, stale or
incomplete. They are research and information, not investment advice. Coverage
is not exhaustive; a vault we do not rate is not a vault we have judged.