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 .
Our wrapper API can be found on the api.originprotocol.com endpoint. Most of the endpoints are wrapping access to our indexer origin-squidnot public, you should rely on the REST wrapper api for stability.
Some dates are displayed as timestamps or epochs, which can be converted to human-readable dates here .
OUSD/OETH Analytics
Trailing yield
GET https://api.originprotocol.com/api/v2/{token}/apr/trailing/{days}{?chainId}
The annualized trailing yield for OUSD, OETH, superOETHb over a given number of days
Number of days greater than 100 may produce unexpected results
Path Parameters
Query Parameters
200: OK
Copy {
"apr" : "8.124428550334684695499731787" ,
"apy" : "8.43"
} Stats
GET https://api.originprotocol.com/api/v2/{token}/stats/{stat}{?chainId}
All available stats for OETH, OUSD and superOETHb
Path Parameters
Query Parameters
Available stats
200: OK
Copy 6098790 // default value is totalSupply Ratios
GET https://api.originprotocol.com/api/v2/{symbol}/ratios{?chainId}
The current credits per token
Path Parameters
Query Parameters
200: OK
Copy {
"current_credits_per_token" : "0.906962953549645688293728531" ,
"next_credits_per_token" : "0.906962953549645688293728531"
} Yield history
GET https://api.originprotocol.com/api/v2/{symbol}/apr/history
The recent annualized historical yield for OUSD or OETH
Path Parameters
200: OK
Copy {
// 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://api.originprotocol.com/api/v2/{symbol}/collateral
A list of backing assets and their balances held by OUSD
Path Parameters
200: OK
Copy {
"collateral" : [
{
"name" : "dai" ,
"total" : "18865713.513970309197419331"
} ,
{
"name" : "usdt" ,
"total" : "10604997.234377000000000000"
} ,
{
"name" : "usdc" ,
"total" : "15085226.289650000000000000"
} ,
{
"name" : "ousd" ,
"total" : "8095696.025185597"
}
]
} Strategies
GET https://api.originprotocol.com/api/v2/{symbol}/strategies{?structured}
A list of OUSD's yield-earning strategies and its token balances
Path Parameters
Query Parameters
200: OK structured
Copy {
"block_time" : 1725289283 ,
"block_number" : 20663645 ,
"strategies" : {
"vault_holding" : {
"name" : "OETH Vault" ,
"address" : "0x39254033945aa2e4809cc2977e7087bee48bd7ab" ,
"icon_file" : "oeth-icon.svg" ,
"total" : 82.639087904602 ,
"tvl" : 82.639087904602 ,
"holdings" : {
"WETH" : 82.6390879045019 ,
"FRXETH" : 0 ,
"STETH" : 8e-18 ,
"RETH" : 1.00114803e-10
} ,
"holdings_value" : {
"WETH" : 82.6390879045019 ,
"FRXETH" : 0 ,
"STETH" : 8e-18 ,
"RETH" : 1.11635358e-10
}
} ,
"frax_eth_strat" : {
"name" : "FraxETH" ,
"address" : "0x3ff8654d633d4ea0fae24c52aec73b4a20d0d0e5" ,
"icon_file" : "frxeth-icon.svg" ,
"total" : 0 ,
"tvl" : 0 ,
"holdings" : {
"SFRXETH" : 0
} ,
"holdings_value" : {
"SFRXETH" : 0
}
} ,
"oeth_curve_amo" : {
"name" : "OETH/ETH Curve AMO" ,
"address" : "0x1827f9ea98e0bf96550b2fc20f7233277fcd7e63" ,
"icon_file" : "oeth-icon.svg" ,
"total" : 7568.50216258337 ,
"tvl" : 7568.50216258337 ,
"holdings" : {
"ETH" : 3562.3529068203 ,
"OETH" : 4019.37421469013
} ,
"holdings_value" : {
"ETH" : 3562.3529068203 ,
"OETH" : 4019.37421469013
}
} ,
"oeth_morpho_aave_strat" : {
"name" : "Morpho Aave" ,
"address" : "0xc1fc9e5ec3058921ea5025d703cbe31764756319" ,
"icon_file" : "morpho.png" ,
"total" : 0 ,
"tvl" : 0 ,
"holdings" : {
"WETH" : 0
} ,
"holdings_value" : {
"WETH" : 0
}
} ,
"oeth_balancer_reth_strat" : {
"name" : "Balancer rETH/WETH Pool Strategy" ,
"address" : "0x49109629ac1deb03f2e9b2fe2ac4a623e0e7dfdc" ,
"icon_file" : "buffer-icon.svg" ,
"total" : 0 ,
"tvl" : 0 ,
"holdings" : {
"RETH" : 0 ,
"WETH" : 0
} ,
"holdings_value" : {
"RETH" : 0 ,
"WETH" : 0
}
}
} ,
"total_value" : 34759.5792065542 ,
"total_value_usd" : 87581369.0353948 ,
"eth_price" : 2519.632603 ,
"total_supply" : 34759.5792065542 ,
"circulating_supply" : 30740.2049918641 ,
"protocol_owned_supply" : 4019.37421469013
} OGN circulating supply
GET https://api.originprotocol.com/circulating-ogn
The number of Origin Tokens (OGN) in circulation
200: OK
OGN total supply
GET https://api.originprotocol.com/total-ogn
The total number of Origin Tokens (OGN) in existence
200: OK
OETH total supply
GET https://api.originprotocol.com/total-oeth
The total number of Origin Ether (OETH) tokens in existence
200: OK
superOETHb total supply
GET https://api.originprotocol.com/total-superoethb
The total number of Origin Dollar (OUSD) tokens in existence
200: OK
OGN protocol revenue
GET https://api.originprotocol.com/api/v2/protocol-fees
Protocol revenue derived from OETH and OUSD performance fees
200: OK
Copy {
"revenue" : {
"now" : 1736391.64 ,
"oneDayAgo" : 1733964.75 ,
"twoDaysAgo" : 1731260.21 ,
"oneWeekAgo" : 1721591.91 ,
"twoWeeksAgo" : 1701508.32 ,
"thirtyDaysAgo" : 1660510.44 ,
"sixtyDaysAgo" : 1592424.46 ,
"ninetyDaysAgo" : 1505980.6
} ,
"days" : [
{
"date" : 1725235200 ,
"revenue" : 2426.88
} ,
{
"date" : 1725148800 ,
"revenue" : 2704.54
} ,
{
"date" : 1725062400 ,
"revenue" : 1426.15
} ,
{
"date" : 1724976000 ,
"revenue" : 3234.23
} ,
// all fee history
]
}
