OlympusDAO

name: OlympusDAO
description: OlympusDAO is a decentralized reserve currency protocol built on Ethereum that pioneered protocol-owned liquidity
  (POL). The Olympus protocol issues OHM, a crypto-native reserve currency backed by a diversified treasury of on-chain assets
  across Ethereum, Arbitrum, Base, Polygon, Fantom, and Berachain. OlympusDAO provides public REST APIs for querying daily
  OHM supply, treasury asset holdings, protocol metrics (price, APY, index), and bond market data — powering the Olympus Treasury
  Dashboard and third-party integrations such as CoinGecko.
image: https://www.olympusdao.finance/images/og-image.png
tags:
- DeFi
- Protocol-Owned Liquidity
- Reserve Currency
- Treasury
- Staking
- Bonds
- OHM
- Ethereum
- Web3
url: https://www.olympusdao.finance/
created: '2021-05-01'
modified: '2026-06-14'
specificationVersion: '0.19'
apis:
- name: Olympus Protocol Metrics API
  description: Cacheable REST API serving daily protocol metrics, treasury asset records, and OHM supply data for the Olympus
    protocol across six EVM chains (Ethereum, Arbitrum, Base, Polygon, Fantom, Berachain). Backed by an Envio HyperIndex indexer
    publishing 8-hour-cadence snapshots to an S3-compatible artifact store. Responses carry a one-hour Cache-Control TTL and
    are served through Cloudflare. Supports a date-range query window of up to 366 days.
  image: https://www.olympusdao.finance/images/og-image.png
  humanURL: https://docs.olympusdao.finance/
  baseURL: https://treasury-subgraph-api.olympusdao.finance
  tags:
  - Treasury
  - Protocol Metrics
  - OHM Supply
  - DeFi
  - REST
  properties:
  - type: Documentation
    url: https://docs.olympusdao.finance/
  - type: OpenAPI
    url: https://treasury-subgraph-api.olympusdao.finance/openapi.json
  - type: GitHubRepository
    url: https://github.com/OlympusDAO/olympus-protocol-metrics-subgraph
  contact:
  - FN: OlympusDAO
    email: ''
    X-twitter: OlympusDAO
    url: https://www.olympusdao.finance/
  meta:
  - tags:
    - DeFi
    - Treasury
    - Protocol Metrics
  endpoints:
  - name: Readiness Probe
    description: 'Returns { "status": "ready" } when the API is healthy. Cached with no-store so load balancers and Cloudflare
      always receive a fresh response.'
    method: GET
    path: /ready
    tags:
    - Health
  - name: Published Date Bounds
    description: Returns the earliest and latest available dates in the published artifact store, maximum range window (default
      366 days), the active indexer deployment identifier, and per-chain indexing progress (block and date). Cached with no-store.
    method: GET
    path: /v2/bounds
    tags:
    - Metadata
  - name: Daily Protocol Metrics
    description: 'Returns daily cross-chain rollup metrics for the requested date range: OHM price, gOHM price, OHM APY, OHM
      index, total supply, circulating supply, floating supply, backed supply, sOHM circulating supply, sOHM TVL, treasury
      market value, treasury liquid backing, and per-chain block/timestamp snapshots. Optionally includes per-record breakdowns
      via includeRecords=true.'
    method: GET
    path: /v2/metrics/daily
    parameters:
    - name: start
      in: query
      required: true
      description: Start date in YYYY-MM-DD format (inclusive). Must fall within the published bounds.
      schema:
        type: string
        format: date
    - name: end
      in: query
      required: false
      description: End date in YYYY-MM-DD format (inclusive). Defaults to the latest published date. Range capped at maxRangeDays.
      schema:
        type: string
        format: date
    - name: includeRecords
      in: query
      required: false
      description: When true, includes per-record treasury asset and OHM supply breakdowns within each daily metric object.
      schema:
        type: boolean
    tags:
    - Protocol Metrics
    - OHM
    - Treasury
  - name: Daily Treasury Assets
    description: 'Returns individual treasury asset records for the requested date range: token symbol, address, chain, wallet,
      price, balance, and USD value — one row per (token, wallet, chain, block) combination. Selected at the canonical block
      snapshot for each UTC day.'
    method: GET
    path: /v2/treasury-assets/daily
    parameters:
    - name: start
      in: query
      required: true
      description: Start date in YYYY-MM-DD format (inclusive).
      schema:
        type: string
        format: date
    - name: end
      in: query
      required: false
      description: End date in YYYY-MM-DD format (inclusive).
      schema:
        type: string
        format: date
    tags:
    - Treasury
    - Assets
  - name: Daily OHM Supply
    description: 'Returns OHM supply attribution records for the requested date range: supply category (Total Supply, Treasury
      holdings, Liquidity-bound, Lending-bound), chain, block, balance, and USD value. Composes into circulating, floating,
      and backed supply at the global level.'
    method: GET
    path: /v2/ohm-supply/daily
    parameters:
    - name: start
      in: query
      required: true
      description: Start date in YYYY-MM-DD format (inclusive).
      schema:
        type: string
        format: date
    - name: end
      in: query
      required: false
      description: End date in YYYY-MM-DD format (inclusive).
      schema:
        type: string
        format: date
    tags:
    - OHM Supply
    - Token Supply
- name: Olympus OHM Circulating Supply API
  description: Serverless GCP Cloud Function that returns the current OHM circulating supply as a plain-text numeric string.
    Reads from a one-hour Firestore cache backed by the Olympus Protocol Metrics API. Used by CoinGecko to display accurate
    circulating supply on the OHM token page. Cache can be bypassed with ?cache=false.
  image: https://www.olympusdao.finance/images/og-image.png
  humanURL: https://github.com/OlympusDAO/coingecko-api
  baseURL: https://circulating-supply.api.olympusdao.finance
  tags:
  - OHM Supply
  - CoinGecko
  - Circulating Supply
  properties:
  - type: GitHubRepository
    url: https://github.com/OlympusDAO/coingecko-api
  contact:
  - FN: OlympusDAO
    url: https://www.olympusdao.finance/
  endpoints:
  - name: OHM Circulating Supply
    description: Returns the current OHM circulating supply as a plain-text numeric string. Cached in Firestore for one hour;
      append ?cache=false to force a live fetch from the treasury subgraph API.
    method: GET
    path: /
    parameters:
    - name: cache
      in: query
      required: false
      description: Set to "false" to bypass the one-hour Firestore cache.
      schema:
        type: string
        enum:
        - 'false'
    tags:
    - OHM Supply
    - Circulating Supply
- name: Olympus OHM Total Supply API
  description: Serverless GCP Cloud Function that returns the current OHM total supply as a plain-text numeric string. Reads
    from a one-hour Firestore cache backed by the Olympus Protocol Metrics API. Used by CoinGecko to display accurate total
    supply on the OHM token page. Cache can be bypassed with ?cache=false.
  image: https://www.olympusdao.finance/images/og-image.png
  humanURL: https://github.com/OlympusDAO/coingecko-api
  baseURL: https://total-supply.api.olympusdao.finance
  tags:
  - OHM Supply
  - CoinGecko
  - Total Supply
  properties:
  - type: GitHubRepository
    url: https://github.com/OlympusDAO/coingecko-api
  contact:
  - FN: OlympusDAO
    url: https://www.olympusdao.finance/
  endpoints:
  - name: OHM Total Supply
    description: Returns the current OHM total supply as a plain-text numeric string. Cached in Firestore for one hour; append
      ?cache=false to force a live fetch from the treasury subgraph API.
    method: GET
    path: /
    parameters:
    - name: cache
      in: query
      required: false
      description: Set to "false" to bypass the one-hour Firestore cache.
      schema:
        type: string
        enum:
        - 'false'
    tags:
    - OHM Supply
    - Total Supply
maintainers:
- FN: OlympusDAO
  X-twitter: OlympusDAO
  url: https://www.olympusdao.finance/