{"uid":"cap_UJu8LD_WRANy-rftY1iD0","slug":"bittensor-subnet-validator-staking-yield-apy-history-7be96e31","name":"Bittensor Subnet Validator Staking Yield & APY History","description":"Validator staking yield and APY breakdown for a specific Bittensor subnet across timeframes (1h, 1d, 7d, 30d APY %) and epoch participation rates. Requires TAOSTATS_API_KEY.","url":"https://api.chainmarket-api.workers.dev/api/crypto/tao-subnet-yield-history?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"page":{"type":"integer","default":1,"minimum":1,"description":"Page number"},"limit":{"type":"integer","default":20,"maximum":50,"minimum":1,"description":"Maximum validators to return (1-50)"},"hotkey":{"type":"string","description":"Optional validator hotkey filter"},"netuid":{"type":"integer","minimum":0,"description":"Subnet network UID (default 1)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_U_nq2a__udn9kRpQXlbPi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns staking yield and APY breakdown (1h, 1d, 7d, 30d) for validators on a specific Bittensor subnet, including epoch participation rates.","exampleAgentPrompt":"What's the staking APY for validators on Bittensor subnet 18 — show me the 1-hour, 1-day, 7-day, and 30-day breakdown along with epoch participation rates, up to 20 validators per page.","exampleUseCases":[{"title":"Evaluating TAO staking returns by subnet","prompt":"I'm thinking about staking TAO on Bittensor — can you pull the 7-day and 30-day APY for validators on subnet 9 so I can see which ones are performing best?"},{"title":"Monitoring a specific validator's yield","prompt":"Can you check the staking yield history for the Bittensor validator with hotkey 5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty on subnet 1, across all timeframes?"},{"title":"Tracking epoch participation for subnet analysis","prompt":"Pull up the epoch participation rates and APY breakdown for the top 50 validators on Bittensor subnet 21 — I want to see who's consistently active."}],"resultDescription":"A paginated list of validators for the specified Bittensor subnet, each with staking yield APY broken down across four timeframes (1h, 1d, 7d, 30d) and their epoch participation rates. Supports filtering by validator hotkey.","failureModes":["Missing or invalid TAOSTATS_API_KEY returns authentication error","Invalid or non-existent netuid returns empty results or error","Hotkey filter with no matching validator returns empty list","Limit exceeding 50 is clamped or rejected","Upstream TAOSTATS API downtime causes request failure"],"whenToPreferThis":"Use this endpoint when you need multi-timeframe staking yield and APY data specifically for Bittensor subnet validators, including epoch participation rates. Prefer this over generic crypto yield APIs when working with TAO staking analytics or comparing validator performance across subnets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T12:31:20.325Z","isFirstParty":false,"canonicalSlug":"bittensor-subnet-validator-staking-yield-apy-history-7be96e31"}