> For the complete documentation index, see [llms.txt](https://docs.pearprotocol.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pearprotocol.io/api-integration/overview.md).

# 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](https://www.npmjs.com/package/@pear-protocol/hyperliquid)

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