Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: YO Risk Graph Public API
version: '1.0'
description: 'The YO Risk Graph (Exponential.fi Risk Ratings) exposed as HTTP APIs. Two surfaces: a free public Vault Exposure endpoint that returns a vault''s current collateral exposure, and a paid Agent API for full risk grading and dependency mapping across pools, assets, protocols and chains. The Agent API is monetized per-call via the x402 micropayment standard (v2) in USDC on Base mainnet (EIP-3009 transferWithAuthorization via Coinbase CDP; payer pays no gas). Paths and parameters are captured from the published docs; per-call prices are recorded as x-x402-price extensions.'
servers:
- url: https://risk.yo.xyz
description: Production
tags:
- name: Public
paths:
/api/v1/public/vault/{chain}/{vaultAddress}/exposure:
get:
operationId: getVaultExposure
summary: Current collateral exposure of a vault (underlying assets, USD value, share of allocation).
description: No API key required. Works with most Morpho vaults today.
tags:
- Public
parameters:
- name: chain
in: path
required: true
description: Chain slug, e.g. ethereum
schema:
type: string
- name: vaultAddress
in: path
required: true
description: Vault contract address
schema:
type: string
responses:
'200':
description: Vault exposure breakdown
content:
application/json:
schema:
$ref: '#/components/schemas/VaultExposureResponse'
components:
schemas:
ExposureEntry:
type: object
properties:
assetId:
type: string
symbol:
type: string
chain:
type: string
exposureUsd:
type: string
exposurePct:
type: string
VaultExposureResponse:
type: object
properties:
data:
type: object
properties:
vault:
type: object
properties:
id:
type: string
name:
type: string
tvlUsd:
type: string
allocatedUsd:
type: string
underlying:
type: array
items:
$ref: '#/components/schemas/ExposureEntry'
collateral:
type: array
items:
$ref: '#/components/schemas/ExposureEntry'
uncollateralizedUsd:
type: string
uncollateralizedPct:
type: string
message:
type: string
statusCode:
type: number