{"uid":"cap_eU81GEj8nw9mW9M5gbN0q","slug":"api-usenami-io-074a4f5a","name":"Nami Perp Volume History","description":"Historical 24h-volume timeseries for one crypto perpetual on one venue, aggregated 1h/4h/1d — liquidity over time for backtests and venue selection. 30–90d window cap.","url":"https://api.usenami.io/v1/perp/volume-history","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"},"method":{"type":"string"}}}}},"responseSchema":null,"example":{"request":{"days":30,"type":"perpetual_futures","venue":"binance","method":"volume_history","ticker":"BTC","granularity":"4h"},"response":{"venue":"binance","ticker":"BTC","buckets":[{"value":12715154052.36,"venue":"binance","samples":1,"bucket_start":"2026-06-11T08:00:00Z"},{"value":12546433767.31,"venue":"binance","samples":1,"bucket_start":"2026-06-11T12:00:00Z"},{"value":11261212837.19,"venue":"binance","samples":1,"bucket_start":"2026-06-11T16:00:00Z"},{"value":12864623854.41,"venue":"binance","samples":1,"bucket_start":"2026-06-11T20:00:00Z"},{"value":12077015473.32,"venue":"binance","samples":1,"bucket_start":"2026-06-12T00:00:00Z"},{"value":11378277006.27,"venue":"binance","samples":1,"bucket_start":"2026-06-12T04:00:00Z"},{"value":11622712945.38,"venue":"binance","samples":1,"bucket_start":"2026-06-12T08:00:00Z"},{"value":10473311174.9,"venue":"binance","samples":1,"bucket_start":"2026-06-12T12:00:00Z"},{"value":11861633867.59,"venue":"binance","samples":1,"bucket_start":"2026-06-12T16:00:00Z"},{"value":9405647065.28,"venue":"binance","samples":1,"bucket_start":"2026-06-12T20:00:00Z"},{"value":9131070055.94,"venue":"binance","samples":1,"bucket_start":"2026-06-13T00:00:00Z"},{"value":8737363048.48,"venue":"binance","samples":1,"bucket_start":"2026-06-13T04:00:00Z"},{"value":7810308890.29,"venue":"binance","samples":1,"bucket_start":"2026-06-13T08:00:00Z"},{"value":7083068430.34,"venue":"binance","samples":1,"bucket_start":"2026-06-13T12:00:00Z"},{"value":5534020951.4,"venue":"binance","samples":1,"bucket_start":"2026-06-13T15:00:00Z"},{"value":4637502409.42,"venue":"binance","samples":1,"bucket_start":"2026-06-13T19:00:00Z"},{"value":4855640469.08,"venue":"binance","samples":1,"bucket_start":"2026-06-13T23:00:00Z"},{"value":4851012418.9,"venue":"binance","samples":1,"bucket_start":"2026-06-14T03:00:00Z"},{"value":5158566618.22,"venue":"binance","samples":1,"bucket_start":"2026-06-14T07:00:00Z"},{"value":4930269234.58,"venue":"binance","samples":1,"bucket_start":"2026-06-14T11:00:00Z"},{"value":5169229310.27,"venue":"binance","samples":1,"bucket_start":"2026-06-14T15:00:00Z"},{"value":4953494140.81,"venue":"binance","samples":1,"bucket_start":"2026-06-14T19:00:00Z"},{"value":7188678722.04,"venue":"binance","samples":1,"bucket_start":"2026-06-14T23:00:00Z"},{"value":8427864611.82,"venue":"binance","samples":1,"bucket_start":"2026-06-15T03:00:00Z"},{"value":8928520289.83,"venue":"binance","samples":1,"bucket_start":"2026-06-15T07:00:00Z"},{"value":9142382915.2,"venue":"binance","samples":1,"bucket_start":"2026-06-15T08:00:00Z"},{"value":9286785139.48,"venue":"binance","samples":1,"bucket_start":"2026-06-15T09:00:00Z"},{"value":12208295678.36,"venue":"binance","samples":1,"bucket_start":"2026-06-15T13:00:00Z"},{"value":13491804481.89,"venue":"binance","samples":1,"bucket_start":"2026-06-15T17:00:00Z"},{"value":12257092096.93,"venue":"binance","samples":1,"bucket_start":"2026-06-15T21:00:00Z"},{"value":10539757575.26,"venue":"binance","samples":1,"bucket_start":"2026-06-16T01:00:00Z"},{"value":10869798777.12,"venue":"binance","samples":1,"bucket_start":"2026-06-16T05:00:00Z"},{"value":11378995333.91,"venue":"binance","samples":1,"bucket_start":"2026-06-16T09:00:00Z"},{"value":9294737573.33,"venue":"binance","samples":1,"bucket_start":"2026-06-16T13:00:00Z"},{"value":8687665008.83,"venue":"binance","samples":1,"bucket_start":"2026-06-16T17:00:00Z"},{"value":8797901579.43,"venue":"binance","samples":1,"bucket_start":"2026-06-16T21:00:00Z"},{"value":8532177609.73,"venue":"binance","samples":1,"bucket_start":"2026-06-17T01:00:00Z"},{"value":7596370047.45,"venue":"binance","samples":1,"bucket_start":"2026-06-17T05:00:00Z"},{"value":8109202570.23,"venue":"binance","samples":1,"bucket_start":"2026-06-17T10:00:00Z"},{"value":8398451258.88,"venue":"binance","samples":1,"bucket_start":"2026-06-17T12:00:00Z"},{"value":8289717096.77,"venue":"binance","samples":1,"bucket_start":"2026-06-17T16:00:00Z"},{"value":8964229780.27,"venue":"binance","samples":1,"bucket_start":"2026-06-17T17:00:00Z"},{"value":11796481806.85,"venue":"binance","samples":1,"bucket_start":"2026-06-17T19:00:00Z"},{"value":13001267090.68,"venue":"binance","samples":1,"bucket_start":"2026-06-17T23:00:00Z"},{"value":13025246054.17,"venue":"binance","samples":1,"bucket_start":"2026-06-18T03:00:00Z"}],"window_end":"2026-06-18T05:26:00Z","aggregation":"1h","window_start":"2026-06-11T05:26:00Z"}},"exampleRequest":{"days":30,"type":"perpetual_futures","venue":"binance","method":"volume_history","ticker":"BTC","granularity":"4h"},"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_jWwPIN3ps_SNC4VnqVhnz","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 historical 24-hour trading volume timeseries (1h, 4h, or 1d granularity) for a perpetual futures ticker/venue pair over a 30–90 day window.","exampleAgentPrompt":"Pull the historical 24h volume timeseries for BTC-PERP on Binance from Nami at 4-hour granularity over the last 30 days so I can spot any unusual volume spikes.","exampleUseCases":null,"resultDescription":"A timeseries array of 24h trading volume data points for the specified ticker and venue, with timestamps and USD volume values at the requested granularity (1h, 4h, or 1d), covering up to a 30–90 day lookback window.","failureModes":["Ticker or venue not supported — returns 404 or empty dataset","Requested window exceeds 90-day cap — may be truncated or return error","Invalid granularity value — returns validation error","Rate limit exceeded — returns 429","Payment not provided or insufficient — returns 402"],"whenToPreferThis":"Use this endpoint when you need historical volume timeseries for a specific perpetual futures market at a specific venue with configurable granularity. Prefer this over the 24h rolling snapshot endpoint when you need multi-day trend data rather than a single current reading, and over open-interest history when volume (not OI) is the relevant signal.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:45:32.835Z","isFirstParty":false}