watchers

WATCHER: get a signed callback when a Hyperliquid...

WATCHER: get a signed callback when a Hyperliquid perpetual's hourly funding rate crosses a level (e.g. flips negative). Arm once, pay once. Pass coin (e.g. BTC, ETH). conditionType 'above'/'below'; threshold is the hourly funding rate (can be negative, e.g. -0.0001). Fires once per crossing; bounded by maxFires/expiry. Data via Hyperliquid. Signed (verify offline) + retried; recoverable via watchers.status. Returns a watcherId.

post/api/watchers/funding-rate

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/watchers/funding-rate
  • Auth: API key in header PAYMENT-SIGNATURE

Request body

coinstring required

Perp coin symbol, e.g. BTC, ETH, SOL.

conditionType'above' | 'below' required

Fire when hourly funding goes above or below the threshold.

thresholdnumber required

Hourly funding rate to cross (can be negative, e.g. -0.0001).

callbackUrlstring uri required

Signed event POSTed here (verify X-2s-Signature). Any http(s) URL.

payloadobject

Arbitrary JSON echoed back in every callback.

expiresInSecondsinteger

Active window in seconds (default 30d, max 90d).

maxFiresinteger

Stop after this many callbacks (default 1).

labelstring

Optional free-text tag.

Response

(unresolved $ref)

Changes

No recorded changes to this operation across all 1 revision of this API.