{"openapi":"3.1.0","info":{"title":"Ethena USDe Synthetic Dollar API","version":"1.0.0","description":"Live data for Ethena's USDe, the largest synthetic dollar in crypto, read keyless from Ethena's public yield feed and directly from the Ethereum blockchain. USDe is not backed by fiat in a bank like USDC — it is a delta-neutral synthetic dollar: Ethena holds staked ETH/BTC and shorts the matching perpetual futures, so the position is hedged to roughly one dollar while the funding and staking it earns become the yield. Stake USDe into sUSDe and you receive that yield; sUSDe is the yield-bearing version and its value in USDe grows every day. The yield endpoint returns Ethena's yields — the current protocol yield and sUSDe staking yield plus the 30-day, 90-day and since-inception average sUSDe APY — the carry the synthetic dollar throws off, which rises and falls with the perpetual-futures funding market. The supply endpoint reads the Ethereum contracts directly: the circulating USDe supply, the amount of USDe staked in sUSDe, the sUSDe share count, the sUSDe-to-USDe exchange rate (how much USDe one sUSDe is now worth — above 1.0 because yield has accrued) and the staking ratio (what share of USDe is staked and earning). The overview endpoint is the at-a-glance snapshot combining the supply and the live yield. This is the Ethena / USDe synthetic-dollar cut — distinct from the generic multi-stablecoin supply feeds, the DeFi lending-rate and yield-aggregator feeds, and the generic ERC-20 token-info feed: the single-protocol view of how the synthetic dollar is sized, staked and yielding. Yields are annualised percentages; supplies are in USDe; the exchange rate is USDe per sUSDe. No key, nothing stored beyond a short cache.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/ethena-api","description":"oanor gateway"}],"tags":[{"name":"Yield"},{"name":"Supply"},{"name":"Overview"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/yield":{"get":{"operationId":"get_v1_yield","tags":["Yield"],"summary":"Protocol + sUSDe staking yields (current, 30d, 90d, inception)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Ethena's yields. protocol_yield_pct is what the whole delta-neutral strategy currently earns (funding + staking); susde_staking_yield_pct is the rate sUSDe holders currently receive; the 30-day, 90-day and since-inception figures are the trailing average sUSDe APY. The yield comes from perpetual-futures funding plus staked-ETH rewards, so it rises and falls with the funding market. Annualised percentages. Live, cached ~5m.","as_of":"10 Jun 26","source":"Ethena public yield API (app.ethena.fi), keyless","susde_apy_30d_pct":3.875,"susde_apy_90d_pct":3.668,"protocol_yield_pct":3.874,"protocol_yield_30d_pct":4.36,"susde_apy_inception_pct":11.195,"susde_staking_yield_pct":3.503},"meta":{"timestamp":"2026-06-12T19:35:41.424Z","request_id":"9447fbad-e213-4fc7-b1c9-bf1bf9814eea"},"status":"ok","message":"Yield retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/supply":{"get":{"operationId":"get_v1_supply","tags":["Supply"],"summary":"USDe supply, USDe staked in sUSDe, sUSDe rate, staking ratio","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"USDe's on-chain size, read straight from the Ethereum contracts. usde_supply is the circulating USDe on Ethereum; usde_staked_in_susde is how much USDe is staked in the sUSDe vault (its totalAssets); susde_to_usde_rate is how much USDe one sUSDe is now worth (above 1.0 — it grows as yield accrues, this is how staking pays out); staking_ratio_pct is the share of all USDe that is staked and earning. Amounts in USDe. Live, cached ~5m.","source":"Ethereum public JSON-RPC (USDe + sUSDe contracts), keyless","usde_supply":4486331312,"susde_shares":1413474622,"staking_ratio_pct":38.92,"susde_to_usde_rate":1.235244,"usde_staked_in_susde":1745986498},"meta":{"timestamp":"2026-06-12T19:35:41.600Z","request_id":"654aa8d6-86b3-4254-bb38-78971a23c93e"},"status":"ok","message":"Supply retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/overview":{"get":{"operationId":"get_v1_overview","tags":["Overview"],"summary":"At-a-glance: supply, staking ratio and live yield","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Ethena USDe at a glance — the circulating USDe supply, how much is staked in sUSDe and the staking ratio, alongside the live sUSDe staking yield and protocol yield. A one-call snapshot of how big the synthetic dollar is and how much it is paying. See /v1/yield and /v1/supply for full detail. Live, cached ~5m.","as_of":"10 Jun 26","source":"Ethena public yield API + Ethereum JSON-RPC, keyless","usde_supply":4486331312,"staking_ratio_pct":38.92,"protocol_yield_pct":3.874,"susde_to_usde_rate":1.235244,"usde_staked_in_susde":1745986498,"susde_staking_yield_pct":3.503},"meta":{"timestamp":"2026-06-12T19:35:41.702Z","request_id":"29972415-a5c7-4164-805c-d8c874d0267f"},"status":"ok","message":"Overview retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"All endpoints take no parameters. Yields are annualised percentages; supplies are in USDe; susde_to_usde_rate is USDe per sUSDe (above 1.0 and rising as yield accrues). USDe supply is read from the Ethereum contract. A ~5-minute cache fronts the upstreams.","source":"Ethena public yield API (app.ethena.fi) + Ethereum public JSON-RPC, keyless, live","service":"ethena-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/yield":"Protocol + sUSDe staking yields (current, 30d, 90d, inception).","GET /v1/supply":"USDe supply, USDe staked in sUSDe, sUSDe rate, staking ratio.","GET /v1/overview":"At-a-glance: supply, staking ratio and live yield in one call."},"description":"Live data for Ethena's USDe, the largest synthetic dollar in crypto, keyless from Ethena's public yield feed and directly from the Ethereum blockchain. USDe is a delta-neutral synthetic dollar (staked ETH/BTC hedged with short perps), and sUSDe is its yield-bearing form. The yield endpoint gives the current protocol and sUSDe staking yields plus the 30-day, 90-day and inception average APY; supply reads the Ethereum contracts for the circulating USDe, the USDe staked in sUSDe, the sUSDe exchange rate and the staking ratio; overview is the at-a-glance snapshot. The Ethena / USDe synthetic-dollar cut — distinct from the generic multi-stablecoin supply feeds, the DeFi lending-rate and yield-aggregator feeds and the generic ERC-20 token-info feed.","sample_yield":{"susde_apy_30d_pct":3.875,"susde_staking_yield_pct":3.503},"upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T19:35:41.768Z","request_id":"d6425664-0ff2-4645-9c29-8e43031e9dbb"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":950,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":2000,"monthly_call_quota":25000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":7200,"monthly_call_quota":138000,"rps_limit":16,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":20100,"monthly_call_quota":560000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/ethena-api"}