# Nami Funding Rate Flip Detector

> Nami Funding Rate Flip Detector is a paid API for AI agents from api.usenami.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

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.

## Facts

- Endpoint: GET https://api.usenami.io/v1/perp/funding-flips
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-usenami-io-db94d2cd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_not9wIAiaiTgShIXHl_AT

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-usenami-io-db94d2cd
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Example request

```json
{
 "input": {
  "type": "perpetual",
  "method": "funding-flips"
 },
 "ticker": "BTC",
 "lookback_hours": 24
}
```

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-usenami-io-db94d2cd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.usenami.io](https://www.zero.xyz/host/api.usenami.io/llms.txt)