Endpoints
The RAX API exposes a set of endpoints that provide access to risk intelligence, rankings, and analytical data.
Endpoints are designed to be composable and predictable, allowing developers to integrate RAX signals into applications, agents, and monitoring systems.
Endpoint Categories
RAX API endpoints are organized into functional categories.
Risk Endpoints
Risk endpoints provide access to normalized risk metrics and indicators.
Typical use cases include:
Monitoring market-level risk
Evaluating protocol or vault risk
Tracking portfolio risk over time
These endpoints return risk scores, supporting metrics, and metadata related to confidence and freshness.
Exposure Endpoints
Exposure endpoints describe dependency and concentration structures.
They allow developers to:
Analyze protocol and chain exposure
Identify concentration risk
Track changes in dependency over time
Exposure data is intended to complement allocation and risk metrics.
Rankings Endpoints
Ranking endpoints provide ordered views of DeFi vaults based on different criteria.
These endpoints power RaxBot jobs and support:
Yield discovery
Risk-aware comparisons
Strategy scouting
Rankings are relative and should be interpreted in context.
Portfolio Endpoints
Portfolio endpoints provide aggregated analytics for connected or referenced portfolios.
They may include:
Portfolio risk scores
Exposure breakdowns
Time series metrics
Simulation summaries
Access to portfolio endpoints may require additional permissions.
Time Series Endpoints
Time series endpoints expose historical data for analysis and visualization.
Common use cases include:
Trend analysis
Backtesting
Alert threshold tuning
Time series availability depends on data retention and configuration.
Request and Response Format
All endpoints return structured JSON responses.
Responses typically include:
Requested data payload
Metadata such as timestamps and freshness
Confidence indicators where applicable
Detailed schemas are described in the Data Schemas section.
Versioning
Endpoints are versioned to ensure stability.
Version identifiers are included in endpoint paths or request headers. Breaking changes are introduced through new versions.
Error Handling
Errors are returned using standard HTTP status codes.
Responses include structured error messages to support debugging and integration resilience.
Summary
RAX API endpoints provide structured access to risk intelligence and analytics.
They are designed to support reliable integration while maintaining flexibility as the system evolves.
Last updated