GET /markets/changes

List scheduled market-parameter changes

List scheduled market-parameter changes.

operationId: fetchMarketChanges

Declared server: https://api.testnet.nexus.xyz/v1. See Networks.

Not reachable through CCXT. Nexus scheduled parameter-change notices. CCXT has no unified shape for announced market-parameter changes.

Authentication: none. This endpoint is public.

List scheduled market-parameter changes

get

/markets/changes

Venue-wide feed of announced market-parameter changes that have not yet taken effect (ENG-9376), so a market maker watching many markets polls one endpoint. A projection of the venue's scheduled market-parameter changes, not a hand-authored post: every entry is a pending schedule read back, so a scheduled change cannot take effect without having appeared here first. Each field's notice_class is computed from the field and its direction of travel against the market's live parameters — the same check the venue enforces when the change activates — never set by an operator. An adverse change (one that can hurt a position already held, e.g. a lower leverage cap or a wider price band) is scheduled at least required_notice_hours ahead; a favourable one may take effect on publication. Only changes that have not yet taken effect are listed. Current values are on the market-parameter reads; activated, cancelled and failed schedules are history and are not carried here. A change applied immediately rather than scheduled appears only as a moved current value.

Responses

200

Scheduled changes that have not yet taken effect, soonest effective_at first.

application/json

The scheduled-change feed (ENG-9376).

429

Rate limit exceeded. Retryable — honour retry-after and back off; this is what separates a 429 from the permanent 403 jurisdiction refusals. Branch on the body's code, which is always RATE_LIMIT_EXCEEDED, and on bucket to learn WHICH budget bottlenecked — the buckets are independent, so a caller at its read ceiling can still submit orders and should not back off the whole client. Do not parse message: it is a diagnostic whose wording is not stable. Requests are charged by weight, so exhausting a budget takes fewer heavy calls than x-ratelimit-limit suggests. See “Rate limits” in the API description.

application/json

get/markets/changes

GET /v1/markets/changes HTTP/1.1
Host: api.testnet.nexus.xyz
Accept: */*

{
  "changes": [
    {
      "schedule_id": "6f1c2e3a-0d4b-4c1e-9a7f-2b8d5e6f7a90",
      "market_id": "BTC-USDX-PERP",
      "announced_at": 1758700800000,
      "effective_at": 1758960000000,
      "notice_given_hours": 72,
      "actor": "operator",
      "fields": [
        {
          "field": "price_band_bps",
          "current_value": 5000,
          "scheduled_value": 6000,
          "value_at_announcement": 5000,
          "notice_class": "adverse",
          "required_notice_hours": 72,
          "notice_satisfied": true
        }
      ]
    }
  ]
}

---

_{API version 0.9.131}