{"id":2274,"date":"2026-06-11T11:26:54","date_gmt":"2026-06-11T11:26:54","guid":{"rendered":"https:\/\/nownodes.io\/blog\/?p=2274"},"modified":"2026-06-11T11:27:49","modified_gmt":"2026-06-11T11:27:49","slug":"statistics-api-user-guide","status":"publish","type":"post","link":"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/","title":{"rendered":"Statistics API User Guide"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Knowing how much of your API quota you&#8217;ve used \u2014 and how much you have left \u2014 sounds like it should be simple. But for developers and teams running applications on top of blockchain infrastructure, that information is surprisingly hard to get without digging through a dashboard every time. The NOWNodes <a href=\"https:\/\/nownodes.gitbook.io\/documentation\/statistics-api\">Statistics API<\/a> solves this by letting you pull your subscription and usage data programmatically, on demand, directly into whatever system you&#8217;re building.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This guide walks you through what the Statistics API does, who can use it, and exactly how to get it working.<\/p>\n\n\n<h2 class=\"wp-block-heading\" id=\"what-the-statistics-api-does\"><strong>What the Statistics API does<\/strong><\/h2>\n\n\n<p class=\"wp-block-paragraph\">At its core, the Statistics API answers one question: where do you stand? Send a request to the endpoint, and you get back a structured snapshot of your current subscription \u2014 when it started, when it expires, how many requests you&#8217;ve made, how many remain, and what percentage of your allocation you&#8217;ve burned through. That&#8217;s the full picture in a single call.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This matters most when you&#8217;re building tools that need to make decisions based on resource availability, or when you want to monitor usage without logging into a dashboard manually. A backend service, a monitoring script, a Slack alert that fires when you hit 80% \u2014 all of these become straightforward once you have programmatic access to this data.<\/p>\n\n\n<h2 class=\"wp-block-heading\" id=\"who-can-use-it\"><strong>Who can use it<\/strong><\/h2>\n\n\n<p class=\"wp-block-paragraph\">The Statistics API is available on NOWNodes Business plans and above. If you&#8217;re on a lower tier and want access, upgrading your subscription will unlock the endpoint.<\/p>\n\n\n<h2 class=\"wp-block-heading\" id=\"the-endpoint\"><strong>The endpoint<\/strong><\/h2>\n\n\n<p class=\"wp-block-paragraph\">Everything happens at a single URL:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>GET https:\/\/api.nownodes.io\/v1.0\/statistics<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">You pass your access token as a query parameter:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>https:&#47;&#47;api.nownodes.io\/v1.0\/statistics?token=YOUR_TOKEN_HERE<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">That&#8217;s it. No request body, no headers beyond what your HTTP client handles automatically. A successful call returns a JSON object with the following fields:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>subscription_type<\/strong> \u2014 the name of your current plan<\/li>\n\n\n\n<li><strong>activated_at<\/strong> \u2014 the date and time your subscription started, in ISO 8601 format<\/li>\n\n\n\n<li><strong>expires_at<\/strong> \u2014 when your subscription ends<\/li>\n\n\n\n<li><strong>used_requests<\/strong> \u2014 the total number of requests consumed so far in this subscription period<\/li>\n\n\n\n<li><strong>request_limit<\/strong> \u2014 your plan&#8217;s maximum request allowance<\/li>\n\n\n\n<li><strong>remaining_requests<\/strong> \u2014 what&#8217;s left<\/li>\n\n\n\n<li><strong>usage_percent<\/strong> \u2014 your consumption as a rounded whole number percentage<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">A real response might look something like this:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n\u00a0\u00a0\"subscription_type\": \"Business\",\n\u00a0\u00a0\"activated_at\": \"2026-01-01T00:00:00Z\",\n\u00a0\u00a0\"expires_at\": \"2026-12-31T23:59:59Z\",\n\u00a0\u00a0\"used_requests\": 4200000,\n\u00a0\u00a0\"request_limit\": 10000000,\n\u00a0\u00a0\"remaining_requests\": 5800000,\n\u00a0\u00a0\"usage_percent\": 42\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Every field in that response is guaranteed to be present \u2014 the API specification marks all of them as required, so you won&#8217;t need to write defensive fallback logic for missing values.<\/p>\n\n\n<h2 class=\"wp-block-heading\" id=\"when-things-go-wrong\"><strong>When things go wrong<\/strong><\/h2>\n\n\n<p class=\"wp-block-paragraph\">The API returns standard HTTP status codes, so error handling is predictable. If your token is missing or invalid, you&#8217;ll get a <strong>401<\/strong> response with a message explaining the authentication problem. If your token exists but your plan doesn&#8217;t include Statistics API access, you&#8217;ll get a <strong>403<\/strong>. Internal server errors come back as <strong>500<\/strong>. In each case, the response body contains a <strong>message<\/strong> field describing what went wrong, which makes debugging straightforward.<\/p>\n\n\n<h2 class=\"wp-block-heading\" id=\"practical-ways-to-use-this\"><strong>Practical ways to use this<\/strong><\/h2>\n\n\n<p class=\"wp-block-paragraph\">The most obvious use case is automated monitoring. Set up a cron job or scheduled function that calls the endpoint every hour, logs the <strong>usage_percent<\/strong>, and sends an alert if it climbs above a threshold. This keeps you from hitting your limit unexpectedly during peak traffic.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Teams building internal tooling can surface this data in dashboards or admin panels, giving non-technical stakeholders visibility into infrastructure usage without needing access to the NOWNodes dashboard directly.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can also use it as a pre-flight check in your application \u2014 if <strong>remaining_requests<\/strong> drops below a defined minimum, your app can throttle its own behavior or surface a warning before you run out entirely.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The Statistics API is a small surface, intentionally so. One endpoint, one token, one clean response. That simplicity is the point: usage data should be easy to get, and now it is.<\/p>\n\n\n\n<div class=\"wp-block-simple-note-info\"><a href=\"mailto:sales@nownodes.io\">Contact our team and we&#8217;ll help you get started, configure your endpoint, and offer ongoing support.<\/a><br\/><br\/>Submit a request through email. Our team will get back to you promptly. <strong>You can test our shared nodes NOW: just <a href=\"https:\/\/account.nownodes.io\/\">sign in<\/a> and get your API Key!<\/strong><\/div>\n","protected":false},"excerpt":{"rendered":"<p>Knowing how much of your API quota you&#8217;ve used \u2014 and how much you have left \u2014 sounds like it should be simple. But for developers and teams running applications on top of blockchain infrastructure, that information is surprisingly hard to get without digging through a dashboard every time. The NOWNodes Statistics API solves this [&hellip;]<\/p>\n","protected":false},"author":5,"featured_media":2275,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_eb_attr":"","_lmt_disableupdate":"","_lmt_disable":"","_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[7],"tags":[203,13,39],"class_list":["post-2274","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-node-guides","tag-api","tag-node-api-manuals","tag-tutorial"],"blocksy_meta":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v22.0 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Statistics API User Guide | NOWNodes Blog<\/title>\n<meta name=\"description\" content=\"Unlock powerful data insights. This guide helps users integrate our statistics API, offering comprehensive documentation for seamless access to robust statistical analysis.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Statistics API User Guide | NOWNodes Blog\" \/>\n<meta property=\"og:description\" content=\"Unlock powerful data insights. This guide helps users integrate our statistics API, offering comprehensive documentation for seamless access to robust statistical analysis.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/\" \/>\n<meta property=\"og:site_name\" content=\"NOWNodes Blog\" \/>\n<meta property=\"article:published_time\" content=\"2026-06-11T11:26:54+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-06-11T11:27:49+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/nownodes.io\/blog\/wp-content\/uploads\/2026\/06\/nodes_1-22.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"2400\" \/>\n\t<meta property=\"og:image:height\" content=\"1200\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Valeria\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@nownodes\" \/>\n<meta name=\"twitter:site\" content=\"@nownodes\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Valeria\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/\"},\"author\":{\"name\":\"Valeria\",\"@id\":\"https:\/\/nownodes.io\/blog\/#\/schema\/person\/91cb6d9a05341ab50375c9205a0e8ad8\"},\"headline\":\"Statistics API User Guide\",\"datePublished\":\"2026-06-11T11:26:54+00:00\",\"dateModified\":\"2026-06-11T11:27:49+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/\"},\"wordCount\":671,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/nownodes.io\/blog\/#organization\"},\"keywords\":[\"API\",\"node api manuals\",\"Tutorial\"],\"articleSection\":[\"Node Guides\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/\",\"url\":\"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/\",\"name\":\"Statistics API User Guide | NOWNodes Blog\",\"isPartOf\":{\"@id\":\"https:\/\/nownodes.io\/blog\/#website\"},\"datePublished\":\"2026-06-11T11:26:54+00:00\",\"dateModified\":\"2026-06-11T11:27:49+00:00\",\"description\":\"Unlock powerful data insights. This guide helps users integrate our statistics API, offering comprehensive documentation for seamless access to robust statistical analysis.\",\"breadcrumb\":{\"@id\":\"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Blog\",\"item\":\"https:\/\/nownodes.io\/blog\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Node Guides\",\"item\":\"https:\/\/nownodes.io\/blog\/category\/node-guides\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Statistics API User Guide\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/nownodes.io\/blog\/#website\",\"url\":\"https:\/\/nownodes.io\/blog\/\",\"name\":\"NOWNodes Blog\",\"description\":\"Your first-to-go source of development guides, web3 analytics and most recent news about NOWNodes\",\"publisher\":{\"@id\":\"https:\/\/nownodes.io\/blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/nownodes.io\/blog\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/nownodes.io\/blog\/#organization\",\"name\":\"NOWNodes Blog\",\"url\":\"https:\/\/nownodes.io\/blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/nownodes.io\/blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/nownodes.io\/blog\/wp-content\/uploads\/2024\/02\/cropped-New-Logo-NN.png\",\"contentUrl\":\"https:\/\/nownodes.io\/blog\/wp-content\/uploads\/2024\/02\/cropped-New-Logo-NN.png\",\"width\":1164,\"height\":1164,\"caption\":\"NOWNodes Blog\"},\"image\":{\"@id\":\"https:\/\/nownodes.io\/blog\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/twitter.com\/nownodes\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/nownodes.io\/blog\/#\/schema\/person\/91cb6d9a05341ab50375c9205a0e8ad8\",\"name\":\"Valeria\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/nownodes.io\/blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/800381d9d7f3d5ae48766e466e03d17c1d24a008075d081667788d429054a691?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/800381d9d7f3d5ae48766e466e03d17c1d24a008075d081667788d429054a691?s=96&d=mm&r=g\",\"caption\":\"Valeria\"},\"url\":\"https:\/\/nownodes.io\/blog\/author\/valeria\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Statistics API User Guide | NOWNodes Blog","description":"Unlock powerful data insights. This guide helps users integrate our statistics API, offering comprehensive documentation for seamless access to robust statistical analysis.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/","og_locale":"en_US","og_type":"article","og_title":"Statistics API User Guide | NOWNodes Blog","og_description":"Unlock powerful data insights. This guide helps users integrate our statistics API, offering comprehensive documentation for seamless access to robust statistical analysis.","og_url":"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/","og_site_name":"NOWNodes Blog","article_published_time":"2026-06-11T11:26:54+00:00","article_modified_time":"2026-06-11T11:27:49+00:00","og_image":[{"width":2400,"height":1200,"url":"https:\/\/nownodes.io\/blog\/wp-content\/uploads\/2026\/06\/nodes_1-22.jpg","type":"image\/jpeg"}],"author":"Valeria","twitter_card":"summary_large_image","twitter_creator":"@nownodes","twitter_site":"@nownodes","twitter_misc":{"Written by":"Valeria","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/#article","isPartOf":{"@id":"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/"},"author":{"name":"Valeria","@id":"https:\/\/nownodes.io\/blog\/#\/schema\/person\/91cb6d9a05341ab50375c9205a0e8ad8"},"headline":"Statistics API User Guide","datePublished":"2026-06-11T11:26:54+00:00","dateModified":"2026-06-11T11:27:49+00:00","mainEntityOfPage":{"@id":"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/"},"wordCount":671,"commentCount":0,"publisher":{"@id":"https:\/\/nownodes.io\/blog\/#organization"},"keywords":["API","node api manuals","Tutorial"],"articleSection":["Node Guides"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/","url":"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/","name":"Statistics API User Guide | NOWNodes Blog","isPartOf":{"@id":"https:\/\/nownodes.io\/blog\/#website"},"datePublished":"2026-06-11T11:26:54+00:00","dateModified":"2026-06-11T11:27:49+00:00","description":"Unlock powerful data insights. This guide helps users integrate our statistics API, offering comprehensive documentation for seamless access to robust statistical analysis.","breadcrumb":{"@id":"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/nownodes.io\/blog\/statistics-api-user-guide\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Blog","item":"https:\/\/nownodes.io\/blog"},{"@type":"ListItem","position":2,"name":"Node Guides","item":"https:\/\/nownodes.io\/blog\/category\/node-guides"},{"@type":"ListItem","position":3,"name":"Statistics API User Guide"}]},{"@type":"WebSite","@id":"https:\/\/nownodes.io\/blog\/#website","url":"https:\/\/nownodes.io\/blog\/","name":"NOWNodes Blog","description":"Your first-to-go source of development guides, web3 analytics and most recent news about NOWNodes","publisher":{"@id":"https:\/\/nownodes.io\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/nownodes.io\/blog\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/nownodes.io\/blog\/#organization","name":"NOWNodes Blog","url":"https:\/\/nownodes.io\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/nownodes.io\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/nownodes.io\/blog\/wp-content\/uploads\/2024\/02\/cropped-New-Logo-NN.png","contentUrl":"https:\/\/nownodes.io\/blog\/wp-content\/uploads\/2024\/02\/cropped-New-Logo-NN.png","width":1164,"height":1164,"caption":"NOWNodes Blog"},"image":{"@id":"https:\/\/nownodes.io\/blog\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/twitter.com\/nownodes"]},{"@type":"Person","@id":"https:\/\/nownodes.io\/blog\/#\/schema\/person\/91cb6d9a05341ab50375c9205a0e8ad8","name":"Valeria","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/nownodes.io\/blog\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/800381d9d7f3d5ae48766e466e03d17c1d24a008075d081667788d429054a691?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/800381d9d7f3d5ae48766e466e03d17c1d24a008075d081667788d429054a691?s=96&d=mm&r=g","caption":"Valeria"},"url":"https:\/\/nownodes.io\/blog\/author\/valeria"}]}},"modified_by":"Valeria","_links":{"self":[{"href":"https:\/\/nownodes.io\/blog\/wp-json\/wp\/v2\/posts\/2274","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nownodes.io\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/nownodes.io\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/nownodes.io\/blog\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/nownodes.io\/blog\/wp-json\/wp\/v2\/comments?post=2274"}],"version-history":[{"count":1,"href":"https:\/\/nownodes.io\/blog\/wp-json\/wp\/v2\/posts\/2274\/revisions"}],"predecessor-version":[{"id":2276,"href":"https:\/\/nownodes.io\/blog\/wp-json\/wp\/v2\/posts\/2274\/revisions\/2276"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/nownodes.io\/blog\/wp-json\/wp\/v2\/media\/2275"}],"wp:attachment":[{"href":"https:\/\/nownodes.io\/blog\/wp-json\/wp\/v2\/media?parent=2274"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/nownodes.io\/blog\/wp-json\/wp\/v2\/categories?post=2274"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/nownodes.io\/blog\/wp-json\/wp\/v2\/tags?post=2274"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}