# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pearprotocol.io/api-integration/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.