{"openapi":"3.1.0","info":{"title":"Marinade API","version":"1.0.0","description":"Live data from Marinade, Solana's largest liquid-staking protocol, where users stake SOL and hold mSOL (a reward-accruing token) or use Marinade Native. The overview endpoint returns the headline state — the mSOL/SOL price, the 30d and 7d staking APY, and the total value locked. The tvl endpoint returns the full TVL breakdown (staked SOL/USD, liquidity, directed, native, self and select stake). The apy endpoint returns the mSOL staking APY over 30d and 7d with the underlying price evolution. The validators endpoint returns Marinade's delegation validator set ranked by stake — each with its name, vote account, data-centre location, commission, activated stake, average APY and uptime. Read live from Marinade, nothing stored. This is Marinade's own Solana liquid-staking, mSOL-yield, TVL and validator layer — distinct from Ethereum staking feeds, on-chain explorers and DEX/price APIs.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/marinade-api","description":"oanor gateway"}],"tags":[{"name":"Overview"},{"name":"TVL"},{"name":"APY"},{"name":"Validators"},{"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/overview":{"get":{"operationId":"get_v1_overview","tags":["Overview"],"summary":"Headline state — mSOL price, APY, TVL","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"solana","source":"Marinade","protocol":"Marinade","total_sol":6630511.8246,"total_usd":416172363.07,"apy_7d_pct":6.9857,"staked_sol":2566867.0513,"staked_usd":161112619.16,"apy_30d_pct":6.0234,"msol_price_sol":1.38638691},"meta":{"timestamp":"2026-06-10T22:57:27.773Z","request_id":"b896482f-958c-4940-aefd-d348308f6257"},"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/tvl":{"get":{"operationId":"get_v1_tvl","tags":["TVL"],"summary":"Full TVL breakdown","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"solana","source":"Marinade","total_sol":6630511.8246,"total_usd":416172363.07,"staked_sol":2566867.0513,"staked_usd":161112619.16,"liquidity_sol":7531.5072,"liquidity_usd":472724.46,"self_staked_sol":1214034.7252,"self_staked_usd":76200407.12,"standard_staked_sol":1352832.3261,"msol_directed_stake_sol":513373.4103,"total_virtual_staked_sol":2536759.0896,"marinade_native_stake_sol":2620686.4305,"marinade_native_stake_usd":164490659.78,"marinade_select_stake_sol":1149073.6273},"meta":{"timestamp":"2026-06-10T22:57:28.314Z","request_id":"d917f35d-192e-4299-8ea0-d5e88625feee"},"status":"ok","message":"TVL 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/apy":{"get":{"operationId":"get_v1_apy","tags":["APY"],"summary":"mSOL staking APY over 30d and 7d","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"apy":[{"window":"30d","apy_pct":6.0234,"end_time":"2026-06-10T22:54:47Z","end_price":1.38638691,"start_time":"2026-05-11T22:49:48Z","start_price":1.37973723},{"window":"7d","apy_pct":6.9857,"end_time":"2026-06-10T22:54:47Z","end_price":1.38638691,"start_time":"2026-06-03T22:49:48Z","start_price":1.3845918}],"note":"mSOL accrues Solana staking rewards; its SOL value rises over time (no rebase).","token":"mSOL","source":"Marinade"},"meta":{"timestamp":"2026-06-10T22:57:28.657Z","request_id":"dafe41b3-121d-4215-9d1d-14fdc943b954"},"status":"ok","message":"APY 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/validators":{"get":{"operationId":"get_v1_validators","tags":["Validators"],"summary":"Marinade validator set ranked by stake","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max results (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":25,"source":"Marinade","validators":[{"url":"https://helius.dev","city":"London","name":"Helius","country":"United Kingdom","version":"4.0.0-rc.1","identity":"HEL1USMZKAL2odpNBj2oCjffnFGaYwmbGmyewGv1e2TU","avg_apy_pct":5.4982,"vote_account":"he1iusunGwqrNtafDtLdhsUQDFvo13z9sUa36PauBtk","superminority":true,"avg_uptime_pct":100,"commission_pct":0,"marinade_stake_sol":0,"activated_stake_sol":15273170.51},{"city":"Toronto","name":"Figment","country":"Canada","version":"4.0.0","identity":"Fd7btgySsrjuo25CJCj7oE7VPMyezDhnx7pZkj2v69Nk","avg_apy_pct":5.1044,"vote_account":"CcaHc2L43ZWjwCHART3oZoJvHLAe9hzT2DJNUpBzoTN1","superminority":true,"avg_uptime_pct":100,"commission_pct":7,"marinade_stake_sol":0,"activated_stake_sol":14805455.23},{"url":"https://www.binance.com","city":"Ashburn","name":"binance staking","country":"United States","version":"4.0.2","identity":"DRpbCBMxVnDK7maPM5tGv6MvB3v1sRMC86PZ8okm21hy","avg_apy_pct":5.4977,"vote_account":"3N7s9zXMZ4QqvHQR15t5GNHyqc89KduzMP7423eWiD5g","superminority":true,"avg_uptime_pct":99.9717,"commission_pct":0,"marinade_stake_sol":0,"activated_stake_sol":13397137.49},{"url":"https://jup.ag","city":"Frankfurt","name":"Jupiter","country":"Germany","version":"4.0.2","identity":"JupmVLmA8RoyTUbTMMuTtoPWHEiNQobxgTeGTrPNkzT","avg_apy_pct":5.3774,"vote_account":"CatzoSMUkTRidT5DwBxAC2pEtnwMBTpkCepHkFgZDiqb","superminority":true,"avg_uptime_pct":100,"commission_pct":5,"marinade_stake_sol":0,"activated_stake_sol":12813614.24},{"url":"https://www.ledger.com/staking","city":"Amsterdam","name":"Ledger by Figment","country":"Netherlands","version":"4.0.0","identity":"q9XWcZ7T1wP4bW9SB4XgNNwjnFEJ982nE8aVbbNuwot","avg_apy_pct":5.1044,"vote_account":"26pV97Ce83ZQ6Kz9XT4td8tdoUFPTng8Fb8gPyc53dJx","superminority":true,"avg_uptime_pct":99.9133,"commission_pct":7,"marinade_stake_sol":0,"activated_stake_sol":9109026.04},{"url":"https://bitwiseinvestments.com","city":"Frankfurt","name":"Bitwise Onchain Solutions","country":"Germany","version":"4.0.0-rc.1","identity":"E1r4Psq84tHfQ6aPTvvDka4U3u8zPVD7gEUrH25RdxHL","avg_apy_pct":5.4994,"vote_account":"8GbwASqdpw4dVcwbWUxbHXMrjyQx2aKkoBR5H1GJF8iD","superminority":true,"avg_uptime_pct":100,"commission_pct":0,"marinade_stake_sol":0,"activated_stake_sol":8124834.5},{"url":"https://everstake.one","city":"Frankfurt","name":"Everstake","country":"Germany","version":"0.909.0-rc.40001","identity":"EvnRmnMrd69kFdbLMxWkTn1icZ7DCceRhvmb2SJXqDo4","avg_apy_pct":5.1055,"vote_account":"9QU2QSxhb24FUX3Tu2FpczXjpK3VYrvRudywSZaM29mF","superminority":true,"avg_uptime_pct":99.9854,"commission_pct":7,"marinade_stake_sol":0,"activated_stake_sol":7474254.92},{"url":"https://www.kraken.com/","city":"London","name":"Kraken 2","country":"United Kingdom","version":"4.0.2","identity":"CAo1dCGYrB6NhHh5xb1cGjUiu86iyCfMTENxgHumSve4","avg_apy_pct":4.9346,"vote_account":"51JBzSTU5rAM8gLAVQKgp4WoZerQcSqWC7BitBzgUNAm","superminority":true,"avg_uptime_pct":100,"commission_pct":10,"marinade_stake_sol":0,"activated_stake_sol":6994178.2},{"url":"https://stakingfacilities.com","city":"Frankfurt","name":"Staking Facilities | MEV 🔥","country":"Germany","version":"0.911.40002","identity":"Awes4Tr6TX8JDzEhCZY2QVNimT6iD1zWHzf1vNyGvpLM","avg_apy_pct":5.4984,"vote_account":"DumiCKHVqoCQKD8roLApzR5Fit8qGV5fVQsJV9sTZk4a","superminority":true,"avg_uptime_pct":100,"commission_pct":0,"marinade_stake_sol":0,"activated_stake_sol":6651179.75},{"city":"Amsterdam","country":"Netherlands","version":"0.1.1","identity":"9jxgosAfHgHzwnxsHw4RAZYaLVokMbnYtmiZBreynGFP","avg_apy_pct":0,"vote_account":"HZKopZYvv8v6un2H6KUNVQCnK5zM9emKKezvqhTBSpEc","superminority":true,"avg_uptime_pct":99.9734,"commission_pct":100,"marinade_stake_sol":0,"activated_stake_sol":6122616.98},{"url":"https://kiln.fi","city":"Amsterdam","name":"Kiln1","country":"Netherlands","version":"4.0.0-rc.1","identity":"5pPRHniefFjkiaArbGX3Y8NUysJmQ9tMZg3FrFGwHzSm","avg_apy_pct":5.2171,"vote_account":"DdCNGDpP7qMgoAy6paFzhhak2EeyCZcgjH7ak5u5v28m","superminority":true,"avg_uptime_pct":100,"commission_pct":5,"marinade_stake_sol":0,"activated_stake_sol":5959646.2},{"url":"https://sol.forwardindustries.com","city":"Secaucus","name":"Forward Industries","country":"United States","version":"0.910.40000","identity":"JD549HsbJHeEKKUrKgg4Fj2iyv2RGjsV7NTZjZUrHybB","avg_apy_pct":5.4993,"vote_account":"3JD3jMmnR6g88qff2WZ3cMHJRjJMUk9yVZtmYTYeFrXf","superminority":true,"avg_uptime_pct":100,"commission_pct":0,"marinade_stake_sol":0,"activated_stake_sol":5935743.9},{"url":"https://galaxy.com/staking","city":"London","name":"Galaxy","country":"United Kingdom","version":"0.911.40002","identity":"9eGrDohdNTAo61DRHyfMuqKWXqYnA3i254Wiszxe8FoY","avg_apy_pct":5.2164,"vote_account":"CvSb7wdQAFpHuSpTYTJnX5SYH4hCfQ9VuGnqrKaKwycB","superminority":true,"avg_uptime_pct":100,"commission_pct":5,"marinade_stake_sol":0,"activated_stake_sol":5837887.96},{"url":"https://upbit.com/staking","city":"Portland","name":"Upbit Staking","country":"United States","version":"4.0.0","identity":"5Cchr1XGEg7dbBXByV5NY2ad8jfxAM7HA3x8D56rq9Ux","avg_apy_pct":0,"vote_account":"GHViLgbrJdZDPb6sphRbeuPNM9cmjsFuGWzrTF1sKF5n","superminority":true,"avg_uptime_pct":99.5386,"commission_pct":100,"marinade_stake_sol":0,"activated_stake_sol":5510480.9},{"city":"Frankfurt","country":"Germany","version":"4.0.0","identity":"9rkJMARqK6VBkcxGfKBAwnA44gPAfGxPbPsfsggFNDSQ","avg_apy_pct":5.0458,"vote_account":"HimWQUK61d9wxhw7EYu9jUje7xQiDs4jKexaTSvuCmXE","superminority":true,"avg_uptime_pct":100,"commission_pct":8,"marinade_stake_sol":0,"activated_stake_sol":4526985.98},{"city":"Dublin","country":"Ireland","version":"4.0.2","identity":"FBKFWadXZJahGtFitAsBvbqh5968gLY7dMBBJUoUjeNi","avg_apy_pct":0,"vote_account":"AZoCYB4VgoM9DR9f1ZFcBn8xPSbtbqoxZnKJR7tkvEoX","superminority":true,"avg_uptime_pct":99.9834,"commission_pct":100,"marinade_stake_sol":0,"activated_stake_sol":4045977.91},{"city":"Frankfurt","country":"Germany","version":"4.0.2","identity":"5ZqveVffQPiUbkjBg4KD9kib1MKHLqiFno4ke9jSq9qk","avg_apy_pct":0,"vote_account":"EcEowA4GKDsdVBF9PNAZa6c9M4WgYG8y4GnpZSUaqioS","superminority":true,"avg_uptime_pct":100,"commission_pct":100,"marinade_stake_sol":0,"activated_stake_sol":3995081.3},{"city":"Frankfurt","country":"Germany","version":"4.0.2","identity":"BtsmiEEvnSuUnKxqXj2PZRYpPJAc7C34mGz8gtJ1DAaH","avg_apy_pct":0,"vote_account":"G9x1mqewTeVnXLmv3FamYD5tq1AdS395RHH3MLQPj6TY","superminority":true,"avg_uptime_pct":100,"commission_pct":100,"marinade_stake_sol":0,"activated_stake_sol":3992045.2},{"city":"Amsterdam","country":"Netherlands","version":"4.0.2","identity":"EkvdKhULbMFqjKBKotAzGi3kwMvMpYNDKJXXQQmi6C1f","avg_apy_pct":0,"vote_account":"3ZYJxzCeweSoh2Jj7oCgencFs9y27iKmXJeqYapje1cj","superminority":true,"avg_uptime_pct":99.9963,"commission_pct":100,"marinade_stake_sol":0,"activated_stake_sol":3983581.25},{"city":"Pittsburgh","country":"United States","version":"0.911.40002","identity":"J6etcxDdYjPHrtyvDXrbCkx3q9W1UjMj1vy1jBFPJEbK","avg_apy_pct":5.4983,"vote_account":"8Pep3GmYiijRALqrMKpez92cxvF4YPTzoZg83uXh14pW","superminority":false,"avg_uptime_pct":99.9817,"commission_pct":0,"marinade_stake_sol":0,"activated_stake_sol":3889304.22},{"city":"London","country":"United Kingdom","version":"4.0.2","identity":"Hz5aLvpKScNWoe9YZWxBLrQA3qzHJivBGtfciMekk8m5","avg_apy_pct":0,"vote_account":"H74qox1GASBWd94FWMyy6GVAbRVLf9SAMgbJ1tzSUAst","superminority":false,"avg_uptime_pct":100,"commission_pct":100,"marinade_stake_sol":0,"activated_stake_sol":3878809.89},{"city":"Amsterdam","country":"Netherlands","version":"4.0.2","identity":"A1vqhA2fS6K7CvHsJKX1ACcHJFEmyRg4KuR5pctHANy4","avg_apy_pct":0,"vote_account":"HkFuE9NJahP7uA8RooXtp64UQb7XNUMVisWsJTgx3far","superminority":false,"avg_uptime_pct":100,"commission_pct":100,"marinade_stake_sol":0,"activated_stake_sol":3847387.54},{"url":"https://coinbase.com/staking","city":"Amsterdam","name":"Coinbase 04","country":"Netherlands","version":"4.0.2","identity":"FNKgX9dYUhYQFRTM9bkeKoRpsyEtZGNMxbdQLDzfqB8a","avg_apy_pct":5.0483,"vote_account":"AaVsZUEnrHUZoXC2oVgTY3GF5GGhzCTBGrjpBtuUWy1H","superminority":false,"avg_uptime_pct":100,"commission_pct":8,"marinade_stake_sol":0,"activated_stake_sol":3740258.38},{"city":"Frankfurt","country":"Germany","version":"4.0.1","identity":"9UM8wQ8F5oMiRcP5YdqD6Lr4krpBWCD8LtgQYoisJd9i","avg_apy_pct":5.3797,"vote_account":"9jToNMWCLW1GeoLGPZNvEfuXE4AUwiRsrC1HMGmh3PTu","superminority":false,"avg_uptime_pct":100,"commission_pct":2,"marinade_stake_sol":0,"activated_stake_sol":3625910.24},{"url":"https://blueshift.gg","city":"Rüsselsheim","name":"blueshift","country":"Germany","version":"4.0.2","identity":"shftkxnsXmqAkmLgz9Mn7bNB5Fr6mKgFc58kFHfVikj","avg_apy_pct":5.503,"vote_account":"shft7Fry1js37Hm9wq4dfwcZSp2DyKszeWMvEpjYCQ1","superminority":false,"avg_uptime_pct":100,"commission_pct":0,"marinade_stake_sol":0,"activated_stake_sol":3619122.94}]},"meta":{"timestamp":"2026-06-10T22:57:29.010Z","request_id":"b29eb05b-b488-40f8-9cec-2abdfafac308"},"status":"ok","message":"Validators 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":{"source":"Marinade API (api.marinade.finance + validators-api.marinade.finance, live)","service":"marinade-api","endpoints":{"GET /v1/apy":"mSOL staking APY over 30d and 7d with price evolution.","GET /v1/tvl":"Full TVL breakdown (staked, liquidity, directed, native, self, select).","GET /v1/meta":"This document.","GET /v1/overview":"Headline state — mSOL/SOL price, 30d/7d APY, total value locked.","GET /v1/validators":"Marinade's validator set ranked by stake (limit=25)."},"apy_30d_pct":6.0234,"description":"Live data from Marinade, Solana's largest liquid-staking protocol, where users stake SOL and hold mSOL (a reward-accruing token) or use Marinade Native, via its public API. The overview endpoint returns the headline state — mSOL/SOL price, 30d and 7d staking APY, and total value locked; the tvl endpoint returns the full TVL breakdown (staked SOL/USD, liquidity, directed, native, self and select stake); the apy endpoint returns the mSOL staking APY over 30d and 7d with the underlying price evolution; the validators endpoint returns Marinade's validator set ranked by stake — name, vote account, location, commission, activated stake, average APY and uptime. Live, no key, nothing stored. Distinct from Ethereum staking feeds, on-chain explorers and DEX/price APIs — this is Marinade's own Solana liquid-staking, mSOL-yield, TVL and validator layer.","msol_price_sol":1.38638691,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T22:57:29.266Z","request_id":"3c752b94-ca46-4c16-9bb9-8703cf791cc1"},"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":3000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":800,"monthly_call_quota":80000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2400,"monthly_call_quota":400000,"rps_limit":45,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5400,"monthly_call_quota":2500000,"rps_limit":130,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/marinade-api"}