Overview

Pear Protocol provides a developer-friendly API for building pair/basket trading on top of Hyperliquid Exchange. Integrates directly via HyperCore, abstracting away complex execution logic.

Suitable for web apps, mobile apps, bots (e.g., Telegram), or direct API integration.

Important: Wallet Separation

Pear builds synthetic positions on top of Hyperliquid's raw positions (see Position Building). This means PnL, entry prices, and position sizes shown in Pear UI will differ from Hyperliquid UI when a user trades on both platforms with the same wallet.

This is a common source of confusion for users. Partners should either:

• Educate users about the difference between Pear's basket-level view and Hyperliquid's asset-level view

• Design UX that clearly communicates this distinction

• Recommend users create a dedicated wallet or Hyperliquid subaccount for pair trading

TypeScript SDK

An official SDK is available on npm:

npm install @pear-protocol/hyperliquid

Package: npmjs.com/package/@pear-protocol/hyperliquid

The SDK covers all API functionality plus charting data which is not available through the REST API directly.