{"uid":"cap_not9wIAiaiTgShIXHl_AT","slug":"api-usenami-io-db94d2cd","name":"Nami Funding Rate Flip Detector","description":"Funding-rate sign-change detection for one crypto perpetual — every positive↔negative flip across venues inside a lookback window, each with its venue, hour and the rates either side of the change. Raw events for spotting funding-regime turns in funding-arb and carry positioning: it reports the flips, it does not classify them as sustained or transient.","url":"https://api.usenami.io/v1/perp/funding-flips","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":{"input":{"type":"perpetual","method":"funding-flips"},"ticker":"BTC","lookback_hours":24},"response":{"flips":[{"hour":"2026-06-12T04:00:00Z","venue":"ApeX Omni","direction":"negative_to_positive","rate_after":0.00001073,"rate_before":-0.00000153},{"hour":"2026-06-12T04:00:00Z","venue":"Crypto.com","direction":"positive_to_negative","rate_after":-0.000003522,"rate_before":0.00000137},{"hour":"2026-06-12T02:00:00Z","venue":"Lighter","direction":"positive_to_negative","rate_after":-0.000032,"rate_before":0.000048},{"hour":"2026-06-12T01:00:00Z","venue":"Binance","direction":"negative_to_positive","rate_after":0.000013,"rate_before":-0.00000321},{"hour":"2026-06-12T01:00:00Z","venue":"MEXC","direction":"negative_to_positive","rate_after":0.000013,"rate_before":-0.000003},{"hour":"2026-06-12T00:00:00Z","venue":"Phemex","direction":"negative_to_positive","rate_after":0.00003765,"rate_before":-0.00003361},{"hour":"2026-06-12T00:00:00Z","venue":"HTX","direction":"negative_to_positive","rate_after":0.0001,"rate_before":-0.0000548991},{"hour":"2026-06-11T23:00:00Z","venue":"dYdX","direction":"negative_to_positive","rate_after":0.0000012013,"rate_before":-0.000001072},{"hour":"2026-06-11T21:00:00Z","venue":"ApeX Omni","direction":"positive_to_negative","rate_after":-0.00000483,"rate_before":0.00000257},{"hour":"2026-06-11T20:00:00Z","venue":"MEXC","direction":"positive_to_negative","rate_after":-0.000012,"rate_before":0.000001},{"hour":"2026-06-11T20:00:00Z","venue":"Binance","direction":"positive_to_negative","rate_after":-0.00001216,"rate_before":0.00000173},{"hour":"2026-06-11T19:00:00Z","venue":"HTX","direction":"positive_to_negative","rate_after":-0.0000189636,"rate_before":0.000022772},{"hour":"2026-06-11T18:00:00Z","venue":"Bitget","direction":"positive_to_negative","rate_after":-0.000003,"rate_before":0.00005},{"hour":"2026-06-11T18:00:00Z","venue":"dYdX","direction":"positive_to_negative","rate_after":-0.0000033556,"rate_before":0.0000582328},{"hour":"2026-06-11T17:00:00Z","venue":"ApeX Omni","direction":"negative_to_positive","rate_after":0.0000125,"rate_before":-0.00000454},{"hour":"2026-06-11T17:00:00Z","venue":"Hyperliquid","direction":"negative_to_positive","rate_after":0.0000053416,"rate_before":-1.162e-7},{"hour":"2026-06-11T16:00:00Z","venue":"Phemex","direction":"positive_to_negative","rate_after":-0.00004467,"rate_before":0.00000767},{"hour":"2026-06-11T16:00:00Z","venue":"Bitget","direction":"negative_to_positive","rate_after":0.00006,"rate_before":-0.000046},{"hour":"2026-06-11T16:00:00Z","venue":"ApeX Omni","direction":"positive_to_negative","rate_after":-0.00000454,"rate_before":0.00000934},{"hour":"2026-06-11T16:00:00Z","venue":"Gate.io","direction":"negative_to_positive","rate_after":0.0001,"rate_before":-0.000006},{"hour":"2026-06-11T15:00:00Z","venue":"Hyperliquid","direction":"positive_to_negative","rate_after":-0.0000033074,"rate_before":9.858e-7},{"hour":"2026-06-11T15:00:00Z","venue":"HTX","direction":"negative_to_positive","rate_after":4.08e-8,"rate_before":-0.0000345297},{"hour":"2026-06-11T15:00:00Z","venue":"ApeX Omni","direction":"negative_to_positive","rate_after":0.00000934,"rate_before":-0.00000812},{"hour":"2026-06-11T13:00:00Z","venue":"ApeX Omni","direction":"positive_to_negative","rate_after":-0.00000354,"rate_before":0.00000529},{"hour":"2026-06-11T12:00:00Z","venue":"Lighter","direction":"negative_to_positive","rate_after":0.000096,"rate_before":-0.000016},{"hour":"2026-06-11T12:00:00Z","venue":"dYdX","direction":"negative_to_positive","rate_after":0.0000080212,"rate_before":-6.949e-7},{"hour":"2026-06-11T11:00:00Z","venue":"Lighter","direction":"positive_to_negative","rate_after":-0.000016,"rate_before":0.000032},{"hour":"2026-06-11T10:00:00Z","venue":"dYdX","direction":"positive_to_negative","rate_after":-4.418e-7,"rate_before":0.0000161552},{"hour":"2026-06-11T10:00:00Z","venue":"HTX","direction":"positive_to_negative","rate_after":-0.0000220127,"rate_before":0.0000039357},{"hour":"2026-06-11T10:00:00Z","venue":"Lighter","direction":"negative_to_positive","rate_after":0.000032,"rate_before":-0.000008},{"hour":"2026-06-11T10:00:00Z","venue":"ApeX Omni","direction":"negative_to_positive","rate_after":0.00000916,"rate_before":-0.00001298},{"hour":"2026-06-11T09:00:00Z","venue":"Lighter","direction":"positive_to_negative","rate_after":-0.000008,"rate_before":0.000016},{"hour":"2026-06-11T08:00:00Z","venue":"ApeX Omni","direction":"positive_to_negative","rate_after":-0.00000623,"rate_before":0.00000932},{"hour":"2026-06-11T07:00:00Z","venue":"Hyperliquid","direction":"negative_to_positive","rate_after":8.221e-7,"rate_before":-5.802e-7},{"hour":"2026-06-11T07:00:00Z","venue":"Phemex","direction":"negative_to_positive","rate_after":8.6e-7,"rate_before":-0.00000622},{"hour":"2026-06-11T06:00:00Z","venue":"ApeX Omni","direction":"negative_to_positive","rate_after":0.00001167,"rate_before":-0.00000397},{"hour":"2026-06-11T06:00:00Z","venue":"Hyperliquid","direction":"positive_to_negative","rate_after":-5.802e-7,"rate_before":0.0000039747},{"hour":"2026-06-11T05:00:00Z","venue":"Lighter","direction":"negative_to_positive","rate_after":0.000024,"rate_before":-0.000032}],"hours":24,"ticker":"BTC","flips_count":38,"venues_with_flips":11}},"exampleRequest":{"input":{"type":"perpetual","method":"funding-flips"},"ticker":"BTC","lookback_hours":24},"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nqsagvZ8nm1VRLLCLKU8C","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Detects positive-to-negative and negative-to-positive funding rate sign changes across perpetual futures venues over a configurable lookback window, distinguishing sustained from transient inversions.","exampleAgentPrompt":"Check for any funding rate sign flips on BTC perpetuals across all venues over the last 24 hours, and tell me which ones are sustained inversions versus transient ones.","exampleUseCases":null,"resultDescription":"A list of detected funding rate sign-change events per venue and ticker, including the direction of the flip (positive-to-negative or negative-to-positive), timestamps, pre/post-flip rate values, and a classification of whether the inversion is sustained or transient.","failureModes":["Missing required 'type' or 'method' fields returns 400 validation error","Unknown ticker or venue returns empty results or 404","Lookback window too long may be capped or return partial data","Rate limit exceeded returns 429","Payment not provided or invalid returns 402"],"whenToPreferThis":"Use this endpoint when you need to identify inflection points in funding rate sentiment — specifically the moment rates cross zero — rather than just checking current rate levels or spreads. It is especially useful for timing mean-reversion trades, detecting shifts in market positioning, or filtering arbitrage signals by whether a funding inversion is fleeting or structural.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:46:39.945Z","isFirstParty":false}