API

Several data endpoints are used internally and by our partners. These have been created incrementally on an as-needed basis and are not intended for widespread use. This documentation has been added for convenience, but please do not rely on this API for mission-critical data. If you need additional data to use in your application, please reach out on Discord.

The are two separate hostnames where different endpoints are hosted. The source code can be found in the ousd-analytics and origin-website GitHub repositories.

Some dates are displayed as timestamps or epochs, which can be converted to human-readable dates here.

OUSD/OETH Analytics

Trailing yield

GET https://analytics.ousd.com/api/v2/{symbol}/apr/trailing/{days}

The annualized trailing yield for OUSD or OETH over a given number of days

Numbers greater than 365 may produce unexpected results

Path Parameters

Name	Type	Description
days	Number	Number of days
symbol*	String	ousd or oeth

200: OK

{
  "apr": "8.124428550334684695499731787",
  "apy": "8.43"
}

Yield history

GET https://analytics.ousd.com/api/v2/{symbol}/apr/history

The recent annualized historical yield for OUSD or OETH

Path Parameters

Name	Type	Description
symbol*	String	ousd or oeth

200: OK

{
  // 30-day apr
  "apr": "8.124428550334684695499731787",
  // 30-day apy
  "apy": "8.43",
  // daily apy for the prior 8+ days
  "daily": [
    {
      // today so far
      "apy": "2.757855899964977550381669000"
    },
    {
      // one day ago
      "apy": "5.203087867622041259311806600"
    },
    {
      // two days ago
      "apy": "5.024625361292970831224569500"
    },
    {
      // three days ago
      "apy": "56.33547497366474799228160500"
    },
    {
      // four days ago
      "apy": "3.735047272855167725188208800"
    },
    {
      // five days ago
      "apy": "3.572624475443835457212147200"
    },
    {
      // six days ago
      "apy": "4.959726075089981319735877800"
    },
    {
      // seven days ago
      "apy": "4.907690010865496625532084100"
    },
    {
      // eight days ago
      "apy": "4.643674734037820771919993600"
    }
  ]
}

Collateral

GET https://analytics.ousd.com/api/v2/{symbol}/collateral

A list of backing assets and their balances held by OUSD or OETH

Path Parameters

Name	Type	Description
symbol*	String	ousd or oeth

200: OK

{
  "collateral": [
    {
      "name": "dai",
      "total": "18865713.513970309197419331"
    },
    {
      "name": "usdt",
      "total": "10604997.234377000000000000"
    },
    {
      "name": "usdc",
      "total": "15085226.289650000000000000"
    },
    {
      "name": "ousd",
      "total": "8095696.025185597"
    }
  ]
}

Strategies

GET https://analytics.ousd.com/api/v2/{symbol}/strategies{?structured}

A list of OUSD's or OETH's yield-earning strategies and their token balances

Path Parameters

Name	Type	Description
symbol*	String	ousd or oeth

Query Parameters

Name	Type	Description
structured	String

200: OK unstructured

{
  "strategies": [
    {
      "name": "Vault",
      "total": 7448.884896,
      "dai": 0,
      "usdt": 7448.884896,
      "usdc": 0,
      "ousd": 0,
      "comp": 0
    },
    {
      "name": "Compound Strategy",
      "total": 17398875.172562208,
      "dai": 7269054.303955209,
      "usdt": 870672.787103,
      "usdc": 9259148.081504,
      "ousd": null,
      "comp": 0
    },
    {
      "name": "Convex Strategy",
      "total": 986822.3425206443,
      "dai": 328940.78084064426,
      "usdt": 328940.78084,
      "usdc": 328940.78084,
      "ousd": null,
      "comp": null
    },
    {
      "name": "Aave Strategy",
      "total": 9671353.458348105,
      "dai": 5770579.280891105,
      "usdt": 3900774.177457,
      "usdc": 0,
      "ousd": null,
      "comp": null
    },
    {
      "name": "Morpho Strategy",
      "total": 300046.72524734936,
      "dai": 100009.00572028894,
      "usdt": 100030.335322,
      "usdc": 100007.091334,
      "ousd": null,
      "comp": 0.29287106042538863
    },
    {
      "name": "OUSD MetaStrategy",
      "total": 16191392.352579273,
      "dai": 2698565.3920966364,
      "usdt": 2698565.3920965,
      "usdc": 2698565.3920965,
      "ousd": 8095696.176289637,
      "comp": null
    }
  ]
}

200: OK structured

{
  "strategies": {
    "vault_holding": {
      "name": "Vault",
      "address": "0xe75d77b1865ae93c7eaa3040b038d7aa7bc02f70",
      "icon_file": "ousd-icon.svg",
      "total": 7448.884896,
      "holdings": {
        "DAI": 0,
        "USDT": 7448.884896,
        "USDC": 0,
        "OUSD": 0,
        "COMP": 0
      }
    },
    "compstrat_holding": {
      "name": "Compound Strategy",
      "address": "0x9c459eeb3fa179a40329b81c1635525e9a0ef094",
      "icon_file": "comp-icon.svg",
      "total": 17398876.638909493,
      "holdings": {
        "DAI": 7269054.913390493,
        "USDT": 870672.883321,
        "USDC": 9259148.842198,
        "COMP": 0
      }
    },
    "threepoolstrat_holding": {
      "name": "Convex Strategy",
      "address": "0xea2ef2e2e5a749d4a66b41db9ad85a38aa264cb3",
      "icon_file": "convex.png",
      "total": 986822.4291960566,
      "holdings": {
        "DAI": 328940.8097320566,
        "USDT": 328940.809732,
        "USDC": 328940.809732
      }
    },
    "aavestrat_holding": {
      "name": "Aave Strategy",
      "address": "0x5e3646a1db86993f73e6b74a57d8640b69f7e259",
      "icon_file": "aave-icon.svg",
      "total": 9671354.787477147,
      "holdings": {
        "DAI": 5770579.834380147,
        "USDT": 3900774.953097,
        "USDC": 0
      }
    },
    "morpho_strat": {
      "name": "Morpho Strategy",
      "address": "0x5a4eee58744d1430876d5ca93cab5ccb763c037d",
      "icon_file": "morpho.png",
      "total": 300046.7593402954,
      "holdings": {
        "DAI": 100009.01410501331,
        "USDT": 100030.352537,
        "USDC": 100007.09955,
        "COMP": 0.29314828210923694
      }
    },
    "ousd_metastrat": {
      "name": "OUSD MetaStrategy",
      "address": "0x89eb88fedc50fc77ae8a18aad1ca0ac27f777a90",
      "icon_file": "buffer-icon.svg",
      "total": 16191392.985012937,
      "holdings": {
        "DAI": 2698565.497502468,
        "USDT": 2698565.497502,
        "USDC": 2698565.497502,
        "OUSD": 8095696.492506469
      }
    }
  }
}

Origin Protocol

OGN circulating supply

GET https://api.originprotocol.com/circulating-ogn

The number of Origin Tokens (OGN) in circulation

200: OK

503712464

OGV circulating supply

GET https://api.originprotocol.com/circulating-ogv

The number of Origin Dollar Governance (OGV) tokens in circulation

200: OK

420803708

OGN total supply

GET https://api.originprotocol.com/total-ogn

The total number of Origin Tokens (OGN) in existence

200: OK OK

1000000000

OGV total supply

GET https://api.originprotocol.com/total-ogv

The total number of Origin Dollar Governance (OGV) tokens in existence

200: OK OK

3975600118

OUSD total supply

GET https://api.originprotocol.com/total-ousd

The total number of Origin Dollar (OUSD) tokens in existence

200: OK

44555185

OETH total supply

GET https://api.originprotocol.com/total-oeth

The total number of Origin Ether (OETH) tokens in existence

200: OK

OGV protocol revenue

GET https://api.originprotocol.com/api/v2/protocol-fees

Protocol revenue derived from OETH and OUSD performance fees

200: OK