Choose a pinned SDK release or current source, then verify the integration.

Build the exact package and examples currently reviewed in the public repository.

npm install https://github.com/InTheta/omni-universe-sdks/releases/download/v0.8.0/omni-terminal-sdk-0.8.0.tgz

# Or verify the current source tree:
git clone https://github.com/InTheta/omni-universe-sdks.git
git -C omni-universe-sdks checkout --detach 763bbd2e85a248118be0a45d391326a02a24de2d
cd omni-universe-sdks/packages/typescript
npm ci
npm run typecheck
npm test
npm run build
npm run test:boundary
npm run test:live

• The npm install command installs a library in your consumer project; it does not install the repository verification commands. Clone source for npm run verify, test:live, and example:*.
• Copy .env.example to .env only when you are ready to add credentials locally.
• The boundary check rejects private hosts and credentials embedded in the distributable package.
• The live suite verifies public contracts and unpaid challenges without setting RUN_PAID_EXAMPLES.

Choose the narrow client that owns the resource you need.

• HyperliquidPublicClient and HyperliquidWebSocketClient: direct public Hyperliquid instruments, candles, mids, trades, and books; no Omni key.
• OmniClient and OmniWebSocketClient: Omni-owned AI News, Ask Omni, and ticketed public WebSocket products; Omni API key where documented.
• OmniX402Client: ten pay-per-request JSON products with official x402 v2 signing and receipt validation.
• OmniMcpClient: free discovery and five typed paid tools, with application-owned payment approval. listTools() shows any other read-only tools the server offers.
• CoinbaseAdvancedTradeClient and RobinhoodCryptoClient: optional broker adapters kept separate from Omni research.

SDK versions are not API versions. These published contract versions were checked on 15 October 2026; fetch the schema again when integrating.

SDK release artifact: v0.8.0 (GitHub tarball; not npm-published)
SDK main source:     v0.8.1 (unreleased)
REST / WS schema:    v1.4.0 — https://omniterminal.app/openapi.yaml
x402 schema:         v0.11.0 — https://omniterminal.app/openapi-x402.yaml
Native MCP:          https://omniterminal.app/api/x402/mcp

GET  /health                         free service health
GET  /api/v1/news/health             free News readiness
GET  /api/v1/news[/{symbol}]         News-scoped x-api-key
POST /api/v1/news/ws-ticket          News-scoped x-api-key
GET  /ws/v1/news?ticket=...          single-use ticket; WebSocket upgrade
POST /api/v1/ask-omni                general API key; see operation security
GET  /api/hl/public-profile          public wallet read
GET  /integrations/defillama/v1/builder-fees  integration access policy

• Do not substitute a News key for a general API key, browser session, vault bearer, or venue trading authority. Keys go in headers, never long-lived WebSocket URLs.
• Terminal browser routes, public keyed REST, x402 HTTP, and native MCP are separate access paths. Use the server URL and security requirements declared on the operation.
• Public Hyperliquid candles and books in this SDK call Hyperliquid directly; they are not evidence of an Omni entitlement or Omni data-plane health.
• Use schema discriminants, freshness and component status to validate responses; OpenAPI examples are representative, not guaranteed current market values.

Start with no secrets, then add one authority at a time.

OMNI_APP_URL=https://omniterminal.app
OMNI_MCP_URL=https://omniterminal.app/api/x402/mcp
X402_MAX_PAYMENT_USD=0.010
RUN_PAID_EXAMPLES=false
LIVE_TRADING=false

# Add only when deliberately testing paid research:
# EVM_PRIVATE_KEY=0x...

# Add broker credentials only for the matching broker example.

• Use a dedicated low-balance EVM wallet for paid research, separate from broker and trading wallets.
• Set RUN_PAID_EXAMPLES=true only for the command you intend to fund, then unset it.
• The source all-routes HTTP example attempts eleven purchases, including both latest and dated roundup queries across ten JSON products. The default $0.010 per-call cap rejects the $0.100 roundup. Do not increase it just to make the example finish; select and approve the exact product deliberately.
• X402_MAX_PAYMENT_USD caps each call, not the total process budget.

Each example is committed next to the package it imports.

npm run example:rest
npm run example:ws
npm run example:news-ws
npm run example:x402
npm run example:mcp
npm run example:coinbase
npm run example:robinhood

• examples/x402-all-routes.ts and examples/mcp-all-tools.ts default to free/no-spend behavior.
• examples/agents/research.ts lets both broker examples select x402 REST or native MCP research.
• Coinbase performs authenticated preview before any live submission.
• Robinhood dry-run returns the v2 order path and proposed order body without signing or transmitting an order request.

A separate package pins every market-data, signing, order, and cancel request to testnet.

# After building the pinned source SDK above:
cd ../../examples/testnet-agents
npm ci
export RUN_TESTNET_ORDERS=false CONFIRM_TESTNET_ORDER= RUN_PAID_RESEARCH=false
export HL_TESTNET_PRIVATE_KEY= EVM_PRIVATE_KEY=
npm run verify
npm run test:live
npm run example:momentum
npm run example:mean-reversion
npm run example:omni-risk:demo

• Momentum and mean-reversion use live testnet candles; Omni Risk uses bounded x402 REST or MCP research.
• These commands force HOLD or capped ALO preview and omit the signed-order probe. Follow the dedicated testnet-agent guide for the canonical installation and funded prerequisites.
• A separately authorized funded lifecycle caps notional at $25, verifies the passive order, cancels it immediately, and verifies removal.
• Never reuse a mainnet key; x402 payer and Hyperliquid testnet keys remain separate.

• SDK README

  https://github.com/InTheta/omni-universe-sdks/blob/main/packages/typescript/README.md

  Canonical release installation, source status, client map, examples, and verification commands.

• SDK package manifest

  https://github.com/InTheta/omni-universe-sdks/blob/main/packages/typescript/package.json

  Defines package version, scripts, engines, exports, and locked dependencies.

• SDK tests

  https://github.com/InTheta/omni-universe-sdks/tree/main/packages/typescript/test

  Covers inputs, response contracts, payment boundaries, MCP, WebSockets, and brokers.

• Hyperliquid testnet agents

  https://github.com/InTheta/omni-universe-sdks/tree/main/examples/testnet-agents

  Runnable, testnet-pinned momentum, mean-reversion, and Omni-risk examples.