{"uid":"cap_dHhv8OEdN8v7AyHhzUrpk","slug":"glassnode-exchange-balance-total-4c37dbe4","name":"Glassnode Exchange Balance (Total)","description":"Balance on Exchanges (Total) — The total amount of coins held on exchange addresses. Data by Glassnode.","url":"https://x402.glassnode.com/v1/metrics/distribution/balance_exchanges","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":{"type":"string","description":"Asset symbol, e.g. BTC, ETH"},"c":{"enum":["native","usd"],"type":"string","description":"Currency for denominated values, e.g. usd, native"},"e":{"type":"string","description":"Exchange name, e.g. binance, coinbase"},"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"},"network":{"enum":["aggregated","arb","base","eth","opt"],"type":"string","description":"Network / blockchain identifier for cross-chain 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_HkaD82DSbPJ1q4c8jLgnK","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 amount of a cryptocurrency held on all exchange addresses, as tracked by Glassnode on-chain analytics.","exampleAgentPrompt":"What's the total amount of BTC currently held on all crypto exchanges according to Glassnode — give me the latest daily figure in native BTC units?","exampleUseCases":null,"resultDescription":"Returns an array of time-series data points, each containing a Unix timestamp (t) and the total balance value (v) representing the amount of the specified cryptocurrency held across exchange addresses. The currency can be in native units or USD depending on the 'c' parameter.","failureModes":["Missing required asset symbol 'a' parameter returns 400 error","Invalid or unsupported asset symbol returns error or empty data","Insufficient USDC payment (requires $0.05) returns 402 Payment Required","Unsupported network/asset combination returns error","Rate limiting or payment failure may return 429 or 402 status"],"whenToPreferThis":"Use this endpoint when you need on-chain exchange balance data sourced from Glassnode — the leading provider of blockchain analytics — specifically to understand how much of a cryptocurrency is held on exchange addresses. Prefer this over generic price APIs when you need market structure insights like exchange reserve trends, potential sell pressure, or accumulation signals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:05:38.596Z","isFirstParty":false}