Skip to main content
Coming Soon: The Developers section is under active development. Documentation will be available soon.

Overview

Public REST API for market data, no authentication required for read-only endpoints.

Base URL

https://api.centuari.io/v1

Market Data

GET /markets

List all markets.
curl https://api.centuari.io/v1/markets
Response:
{
  "markets": [
    {
      "id": "usdc-90d",
      "asset": "USDC",
      "maturity": "90d",
      "lendRate": 0.078,
      "borrowRate": 0.092,
      "totalLent": "5000000",
      "totalBorrowed": "4200000"
    }
  ]
}

GET /markets/:id/orderbook

Get order book for a market.
curl https://api.centuari.io/v1/markets/usdc-90d/orderbook
Response:
{
  "lends": [
    { "rate": 0.085, "amount": "100000" },
    { "rate": 0.082, "amount": "250000" }
  ],
  "borrows": [
    { "rate": 0.078, "amount": "150000" },
    { "rate": 0.075, "amount": "80000" }
  ]
}

GET /markets/rates

Current rates across all markets.
curl https://api.centuari.io/v1/markets/rates

Analytics

GET /analytics/tvl

Total value locked over time.
curl https://api.centuari.io/v1/analytics/tvl?period=30d

GET /analytics/volume

Trading volume over time.
curl https://api.centuari.io/v1/analytics/volume?period=30d

GET /analytics/rates

Historical rate data.
curl "https://api.centuari.io/v1/analytics/rates?asset=USDC&maturity=90d&period=30d"

Vaults

GET /vaults

List all vaults.
curl https://api.centuari.io/v1/vaults

GET /vaults/:id

Get vault details.
curl https://api.centuari.io/v1/vaults/steady-yield

Rate Limits

EndpointLimit
Public (no auth)60/min
Authenticated300/min

Response Format

All responses include:
{
  "data": { ... },
  "timestamp": "2025-03-15T14:32:00Z"
}
Errors:
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests"
  }
}