Errors

Resource methods throw a RequestError for any non-2xx response, so you handle failures with try/catch rather than inspecting each result. On success, a method resolves with its typed payload. RequestError exposes:

code: a stable error category, so you can branch on an enum instead of parsing strings. Route errors use INVALID_REQUEST, NOT_FOUND, INSUFFICIENT_BALANCE, IDEMPOTENCY_CONFLICT, ORDER_NOT_CANCELLABLE, ORDER_RECONCILIATION_REQUIRED and INTERNAL_ERROR; signed-auth rejections use UNAUTHORIZED, FORBIDDEN, AUTH_UNAVAILABLE and BAD_CONTENT_HASH. It is undefined for a response that carries no error envelope.
status: the HTTP status code.
message: a human-readable explanation.

import { createClient, RequestError } from "@parlayx/sdk";

const client = createClient({
  keyId: process.env.PARLAYX_KEY_ID!,
  privateKeyHex: process.env.PARLAYX_PRIVATE_KEY_HEX!,
});

try {
  const balance = await client.polymarket.getBalance();
  console.log(balance.available);
} catch (error) {
  if (!(error instanceof RequestError)) throw error;

  switch (error.code) {
    case "INSUFFICIENT_BALANCE":
      console.error("Not enough spendable balance:", error.message);
      break;
    case "NOT_FOUND":
      console.error("Resource not found:", error.message);
      break;
    case "UNAUTHORIZED":
      /* A drifted clock presents exactly like a bad key, so check both. */
      console.error("Signature rejected:", error.message);
      break;
    default:
      console.error(`Request failed (${error.status}):`, error.message);
  }
}

Authentication failures arrive in the same envelope as route errors, so code is populated: a rejected signature is a 401 with UNAUTHORIZED, and a key without the capability for a route is a 403 with FORBIDDEN.

TypeScript SDK

Streaming