Skip to Content
PredictorSDK

SDKs 0.24.0 retry the same way, load with require, and expose request ids

The TypeScript, Python and Go SDKs 0.24.0 retry failures the same way in every language, load with require() as well as import, expose each response's request id on errors, ship their license, and drop stream options that configured nothing.

SDKBreaking

The TypeScript (@predictorsdk/client), Python (predictorsdk), and Go (github.com/PredictorSDK/sdk-go) SDKs are released at 0.24.0. One change can break code that compiled against 0.23: the stream options are gone (last item). Nothing else in a request or response changed shape.

  • One retry policy. Every SDK makes the request plus two retries by default; the Go SDK made one retry before. All three also retry a connection that failed before any response arrived (refused, reset, or closed), which only the Python SDK did. A timeout or a cancelled request is never retried, and cancelling ends a wait between retries at once.
  • require() works. The TypeScript package ships a CommonJS build beside the ES module one, so require("@predictorsdk/client") works on every Node version the package supports. It threw ERR_REQUIRE_ESM on Node 18 and on Node 20 before 20.19.
  • Errors carry the request id. Every API response now has an X-Request-Id header, and the SDKs expose it on errors: error.requestId in TypeScript, error.headers["x-request-id"] in Python, and apiErr.Header.Get("X-Request-Id") on a Go *core.APIError. Quote it when you report a problem; see error handling.
  • New value and tighter types. tradingFees.chargeBasis can be close_or_settlement: Hyperliquid outcome markets charge only when you close or settle a position. A scheduled fee change's taker and maker are never null, and the types now say so; the current taker and maker can still be null, and trading fees says when.
  • Packaging. The npm package and the Python wheel and sdist include the MIT license. The Python wheel no longer installs the generator's tests, and pip install "predictorsdk[aiohttp]", which the client suggests for its async default, now installs the aiohttp transport.
  • Removed: stream options. The API has no streaming endpoints, so the generator's stream reconnection settings configured nothing: Python's stream_reconnection_enabled and max_stream_reconnection_attempts (client and request options), TypeScript's stream client option, and Go's option.WithMaxStreamReconnectAttempts and option.WithoutStreamReconnection. Code that passed them must drop them.

We checked each published package against the production API before announcing it: each one paged through matched events, read the default verdict and the includeRules rows on NFL games, looked up an event, read a market and an event, read the request id off an error, and read Hyperliquid's new charge basis. The TypeScript check also loaded the package with require(), and the Python check confirmed the license, the absent tests, the aiohttp extra and the removed options.