{"uid":"cap_O4O8FMcJsuCA-WsWluy0r","slug":"glassnode-miner-wallet-balance-btc-77fb01af","name":"Glassnode Miner Wallet Balance (BTC)","description":"Balance in Miner Wallets — The total supply held in miner addresses. Data by Glassnode.","url":"https://x402.glassnode.com/v1/metrics/distribution/balance_miners_sum","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":["a"],"properties":{"a":{"enum":["BTC"],"type":"string","description":"Asset symbol, e.g. BTC, ETH"},"c":{"enum":["native","usd"],"type":"string","description":"Currency for denominated values, e.g. usd, native"},"f":{"enum":["csv","json"],"type":"string","description":"Response format: json or csv"},"i":{"enum":["24h"],"type":"string","description":"Time interval / resolution, e.g. 24h, 1w, 1month"},"miner":{"enum":["1THash&58COIN","AntPool","ArkPool","BTC.TOP","BTC.com","BinancePool","BitFury","BitMinter","Bixin","DPool","F2Pool","FoundryUSAPool","Genesis","HuobiPool","KuCoinPool","Lubian.com","LuxorTech","MaraPool","NovaBlock","OKExPool","Patoshi","PegaPool","Poolin","SBICrypto","SecPool","SigmaPool","SlushPool","SpiderPool","TerraPool","UKRPool","Ultimus","ViaBTC","aggregated","other"],"type":"string","description":"Miner identifier for mining-related metrics"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number"},"v":{"type":"number"}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_e3EQSd32S3tC1f9Xgng6S","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the total BTC supply held in miner addresses over time, optionally filtered by specific miner entity.","exampleAgentPrompt":"What is the total BTC balance held in miner wallets right now? Pull the aggregated miner supply data from Glassnode in native BTC denomination.","exampleUseCases":null,"resultDescription":"Returns a time-series array of objects, each with a Unix timestamp ('t') and the total BTC balance held in miner wallets ('v'), reflecting the aggregate or per-miner supply at daily resolution.","failureModes":["Missing required 'a' query parameter (asset) returns 400 error","Invalid miner identifier enum value returns 400 error","Payment not included or insufficient USDC causes 402 Payment Required","Requesting unsupported asset other than BTC returns error","Rate limiting or upstream Glassnode data unavailability returns 5xx error"],"whenToPreferThis":"Use this endpoint when you need on-chain miner wallet balance data for Bitcoin, particularly to analyze miner accumulation/distribution behavior, track specific mining pool holdings, or build macro BTC supply analysis. Prefer this over exchange balance endpoints when the focus is miner-side supply dynamics rather than retail or institutional holdings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:54:37.427Z","isFirstParty":false}