API Reference

This page lists the public Nunchi API surfaces external integrators should use today.

Surface	Protocol	Base URL	Use
SWP feeds	HTTP JSON / SSE	Per-feed Railway origins, or same-origin nunchi.trade proxies	BTCSWP, HYPESWP, ETHCSWP, and SPCXSWP oracle prices
ISFR feed	HTTP JSON	https://house.nunchi.trade/isfr	Composite ISFR, history, sub-indices, OHLC, and source metadata

For product context, start with BTCSWP, Feed API, Points API, and ISFR Index.

SWP Feed APIs

SWP feeds are public read-only endpoints for Nunchi funding-rate markets. They are appropriate for dashboards, market monitors, and model inputs. They do not place orders and do not require wallet authentication.

Feed Directory

Feed	Reference asset	Public base URL	Latest tick	Stream
BTCSWP	Core Hyperliquid BTC funding	https://cfi-api-production.up.railway.app	/api/latest	/api/stream
HYPESWP	Core Hyperliquid HYPE funding	https://hypeswp-api-production.up.railway.app	/api/latest	/api/stream
ETHCSWP	Core Hyperliquid ETH funding	https://ethcswp-api-production.up.railway.app	/api/latest	/api/stream
SPCXSWP	xyz:SPCX funding	https://spcx-swp-api-production.up.railway.app	/api/latest	/api/stream

Same-Origin Proxies

Browser clients can use Nunchi same-origin proxies when available:

Proxy endpoint	Upstream feed
GET https://nunchi.trade/api/feeds/btcswp/latest	BTCSWP latest tick
GET https://nunchi.trade/api/feeds/btcswp/stream	BTCSWP SSE stream
GET https://nunchi.trade/api/feeds/hypeswp/latest	HYPESWP latest tick
GET https://nunchi.trade/api/feeds/hypeswp/stream	HYPESWP SSE stream
GET https://nunchi.trade/api/feeds/ethcswp/latest	ETHCSWP latest tick
GET https://nunchi.trade/api/feeds/ethcswp/stream	ETHCSWP SSE stream
GET https://nunchi.trade/api/feeds/spcxswp/latest	SPCXSWP latest tick
GET https://nunchi.trade/api/feeds/spcxswp/stream	SPCXSWP SSE stream

Health

GET /healthz

Example:

curl https://cfi-api-production.up.railway.app/healthz

Example response:

{ "status": "ok" }

Latest Tick

GET /api/latest

Example:

curl https://cfi-api-production.up.railway.app/api/latest

Example response:

{
  "oracle_px": "74942.980893"
}

Streaming Ticks

GET /api/stream
Accept: text/event-stream

Example:

const events = new EventSource("https://cfi-api-production.up.railway.app/api/stream");

events.addEventListener("price", (event) => {
  const tick = JSON.parse(event.data);
  console.log(tick.oracle_px);
});

Each event uses event: price and includes the current oracle price.

SWP Response Fields

Field	Meaning
oracle_px	Current oracle price for the SWP feed. Use this as the headline price.

ISFR API

The Implied Secured Funding Rate (ISFR) API publishes the composite benchmark and its sub-indices. It is public read-only and does not require authentication.

Base URL: https://house.nunchi.trade
Dashboard: https://house.nunchi.trade/isfr

Health

GET /isfr/health

Current ISFR

GET /isfr/v1/isfr/current

Example:

curl https://house.nunchi.trade/isfr/v1/isfr/current

Example response shape:

{
  "isfr_bps": 690,
  "rate": 0.06895,
  "rate_formatted": "6.90%",
  "components": {
    "lending": 620,
    "structured": 710,
    "funding": 1240,
    "staking": 320
  },
  "confidence": 0.876,
  "class_weights_effective": {
    "lending": 0.6,
    "structured": 0.25,
    "funding": 0.1,
    "staking": 0.05
  },
  "timestamp": "2026-04-14T11:42:00+00:00",
  "version": "v3.0"
}

History

GET /isfr/v1/isfr/history?days=30

Sub-Indices

GET /isfr/v1/isfr/subindex/{class_name}

class_name must be one of lending, structured, funding, or staking.

Sources

GET /isfr/v1/isfr/sources

OHLC

GET /isfr/v1/isfr/ohlc?days=180&interval=1D

Supported intervals: 1H, 4H, 1D, 1W.

Quick Reference

# BTCSWP latest oracle price
curl https://cfi-api-production.up.railway.app/api/latest

# HYPESWP latest oracle price
curl https://hypeswp-api-production.up.railway.app/api/latest

# ETHCSWP latest oracle price
curl https://ethcswp-api-production.up.railway.app/api/latest

# SPCXSWP latest oracle price
curl https://spcx-swp-api-production.up.railway.app/api/latest

# ISFR current rate
curl https://house.nunchi.trade/isfr/v1/isfr/current