# Yieldbay Public API

Human docs: https://api.yieldbay.fi/docs
Docs: https://api.yieldbay.fi/docs.md
Base URL: https://api.yieldbay.fi

Primary endpoints for agents:
- GET /v1/health/summary
- GET /v1/health/insight
- GET /v1/health/events?limit=50&sort=latest
- GET /v1/health/incidents?limit=50&sort=severity
- GET /v1/yields
- GET /v1/yields/tokens/:mint
- GET /v1/wallets/:wallet/portfolio
- GET /v1/wallets/:wallet/snapshots
- GET /v1/me/usage
- GET /v1/wallets/:wallet/api-access
- POST /v1/auth/nonce
- POST /v1/me/api-keys
- POST /v1/me/api-keys/:keyId/rotate
- POST /v1/me/api-keys/:keyId/revoke

Authentication: use Authorization: Bearer <api_key> or X-API-Key: <api_key>.
Scopes: health:read (health endpoints), yields:read (/v1/yields), portfolio:read (/v1/wallets/*). A key carries scopes; the wallet tier decides which are entitled.
Usage and limits are wallet-scoped and come from the wallet tier: global per-minute/per-month limits plus per-endpoint-group windows (health, yields, portfolio, snapshots, account). Wallet portfolio calls are the expensive, tightly limited group.
All timestamps in API responses are ISO-8601 strings unless a field ends in _ms.