API Reference

Funding Intervals

The Intervals API tracks funding rate interval changes — when exchanges switch symbols between 8h and 4h (or other) funding periods. This data is useful for understanding when market dynamics shift.

All endpoints are public. No authentication required.

List Interval Changes

GET /v1/intervals

Returns a list of all funding interval change events.

curl https://api.settled.pro/v1/intervals

{
  "data": [
    {
      "id": "i1a2b3c4-...",
      "exchange": "binance",
      "symbol": "BTCUSDT",
      "from_interval": "8h",
      "to_interval": "4h",
      "changed_at": "2026-03-10T00:00:00Z"
    }
  ]
}

Interval Change Stats

GET /v1/intervals/stats

Returns aggregate statistics about interval changes across all exchanges and symbols.

curl https://api.settled.pro/v1/intervals/stats

{
  "data": {
    "total_changes": 1284,
    "exchanges": {
      "binance": 842,
      "bybit": 312,
      "okx": 130
    },
    "most_changed_symbols": [
      { "symbol": "BTCUSDT", "changes": 42 },
      { "symbol": "ETHUSDT", "changes": 38 }
    ]
  }
}

Threaded Interval View

GET /v1/intervals/threaded

Returns a paginated, searchable, sortable view of interval changes grouped by symbol.

exchangestring

Filter by exchange (e.g. binance, bybit, okx)

sortstring

Sort field: changes or symbol

orderstring

asc or desc

pageinteger

Page number (0-indexed)

limitinteger

Max results per page

searchstring

Filter by symbol substring (e.g. BTC)

curl "https://api.settled.pro/v1/intervals/threaded?exchange=binance&sort=changes&order=desc&page=0&limit=30&search=BTC"

{
  "data": [
    {
      "symbol": "BTCUSDT",
      "exchange": "binance",
      "change_count": 42,
      "current_interval": "4h",
      "last_changed_at": "2026-03-15T00:00:00Z"
    }
  ],
  "meta": {
    "page": 0,
    "limit": 30,
    "total": 148
  }
}

Symbol Interval History

GET /v1/intervals/{exchange}/{symbol}

Returns the full interval change history for a specific symbol on an exchange.

curl https://api.settled.pro/v1/intervals/binance/BTCUSDT

{
  "data": {
    "exchange": "binance",
    "symbol": "BTCUSDT",
    "current_interval": "4h",
    "history": [
      {
        "from_interval": "8h",
        "to_interval": "4h",
        "changed_at": "2026-03-10T00:00:00Z"
      },
      {
        "from_interval": "4h",
        "to_interval": "8h",
        "changed_at": "2025-11-01T00:00:00Z"
      }
    ]
  }
}

Symbol Interval Analysis

GET /v1/intervals/{exchange}/{symbol}/analysis

Returns trend analysis and statistics for interval changes on a given symbol.

curl https://api.settled.pro/v1/intervals/binance/BTCUSDT/analysis

{
  "data": {
    "exchange": "binance",
    "symbol": "BTCUSDT",
    "total_changes": 42,
    "avg_days_between_changes": 12.4,
    "most_common_direction": "8h_to_4h",
    "volatility_score": 0.74
  }
}
← PreviousLeaderboardNext →Crowd Positioning