Class SwitchboardSurgeTask

Fetch a live spot price straight out of the global Surge websocket cache – the same cache that powers our high-speed on-chain oracles.

Input • symbol – the trading-pair symbol as it appears on the exchange • source – which exchange’s stream to read from • BINANCE (weight 3) • BYBIT (weight 2) • OKX (weight 2) • COINBASE (weight 1) • WEIGHTED (default) – use the weighted median of all fresh quotes with the weights shown above.

Returns The most recent price available from the chosen source. The task fails if the cached tick is older than 5 s.

Example: Pull the Binance price for BTC / USDT

{
"switchboardSurgeTask": {
"source": "BINANCE",
"symbol": "BTC/FDUSD"
}
}

Example: Use the weighted-median oracle for BTC / USDT

{
"switchboardSurgeTask": {
"source": "WEIGHTED",   // or omit — WEIGHTED is the default
"symbol": "BTC/USD"
}
}

Notes • Symbols are auto-normalised (case-insensitive, punctuation removed). • If a venue’s price is stale (> 5 s) it is ignored in the WEIGHTED calculation. The task errors if no fresh price remains. • The weighted-median algorithm is the same one Hyperliquid uses in production: cumulative weights 3 / 2 / 2 / 1 / 1 / 1 / 1 / 1 across the eight venues (we currently stream the first four).

Implements

Constructors

constructor

Properties

source symbol

Methods

toJSON create decode decodeDelimited encode encodeDelimited fromObject getTypeUrl toObject verify

Constructors

constructor

Properties

source

source: Source

Determines which source will be used for pricing. Default: WEIGHTED average across all sources.

symbol

symbol: string

SwitchboardSurgeTask symbol.

Methods

toJSON

  • toJSON(): { [k: string]: any }

    Converts this SwitchboardSurgeTask to JSON.

    Returns { [k: string]: any }

    JSON object

Staticcreate

Staticdecode

  • decode(
        reader: Uint8Array<ArrayBufferLike> | Reader,
        length?: number,
    ): OracleJob.SwitchboardSurgeTask

    Decodes a SwitchboardSurgeTask message from the specified reader or buffer.

    Parameters

    • reader: Uint8Array<ArrayBufferLike> | Reader

      Reader or buffer to decode from

    • Optionallength: number

      Message length if known beforehand

    Returns OracleJob.SwitchboardSurgeTask

    SwitchboardSurgeTask

    Throws

    If the payload is not a reader or valid buffer

    Throws

    If required fields are missing

StaticdecodeDelimited

  • decodeDelimited(
        reader: Uint8Array<ArrayBufferLike> | Reader,
    ): OracleJob.SwitchboardSurgeTask

    Decodes a SwitchboardSurgeTask message from the specified reader or buffer, length delimited.

    Parameters

    • reader: Uint8Array<ArrayBufferLike> | Reader

      Reader or buffer to decode from

    Returns OracleJob.SwitchboardSurgeTask

    SwitchboardSurgeTask

    Throws

    If the payload is not a reader or valid buffer

    Throws

    If required fields are missing

Staticencode

  • encode(message: ISwitchboardSurgeTask, writer?: Writer): Writer

    Encodes the specified SwitchboardSurgeTask message. Does not implicitly {@apilink oracle_job.OracleJob.SwitchboardSurgeTask.verify|verify} messages.

    Parameters

    • message: ISwitchboardSurgeTask

      SwitchboardSurgeTask message or plain object to encode

    • Optionalwriter: Writer

      Writer to encode to

    Returns Writer

    Writer

StaticencodeDelimited

  • encodeDelimited(message: ISwitchboardSurgeTask, writer?: Writer): Writer

    Encodes the specified SwitchboardSurgeTask message, length delimited. Does not implicitly {@apilink oracle_job.OracleJob.SwitchboardSurgeTask.verify|verify} messages.

    Parameters

    • message: ISwitchboardSurgeTask

      SwitchboardSurgeTask message or plain object to encode

    • Optionalwriter: Writer

      Writer to encode to

    Returns Writer

    Writer

StaticfromObject

  • fromObject(object: { [k: string]: any }): OracleJob.SwitchboardSurgeTask

    Creates a SwitchboardSurgeTask message from a plain object. Also converts values to their respective internal types.

    Parameters

    • object: { [k: string]: any }

      Plain object

    Returns OracleJob.SwitchboardSurgeTask

    SwitchboardSurgeTask

StaticgetTypeUrl

  • getTypeUrl(typeUrlPrefix?: string): string

    Gets the default type url for SwitchboardSurgeTask

    Parameters

    Returns string

    The default type url

StatictoObject

  • toObject(
        message: OracleJob.SwitchboardSurgeTask,
        options?: IConversionOptions,
    ): { [k: string]: any }

    Creates a plain object from a SwitchboardSurgeTask message. Also converts values to other types if specified.

    Parameters

    Returns { [k: string]: any }

    Plain object

Staticverify

  • verify(message: { [k: string]: any }): null | string

    Verifies a SwitchboardSurgeTask message.

    Parameters

    • message: { [k: string]: any }

      Plain object to verify

    Returns null | string

    null if valid, otherwise the reason why it is not

Settings

Member Visibility

On This Page

Constructors
Properties
Methods