> ## Documentation Index
> Fetch the complete documentation index at: https://docs.strike.markets/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Market Details (includes Open Interest)

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.strike.markets/market/BTC-USD"
  ```

  ```javascript JavaScript theme={null}
  const symbol = "BTC-USD";

  const response = await fetch(`https://api.strike.markets/market/${symbol}`);
  const oiData = await response.json();

  console.log(`Open Interest for ${symbol}:`, oiData);
  ```

  ```python Python theme={null}
  import requests

  symbol = "BTC-USD"

  response = requests.get(f'https://api.strike.markets/market/{symbol}')
  oi_data = response.json()

  print(f'Open Interest for {symbol}:', oi_data)
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "symbol": "BTC-USD",
    "position_multiplier": "0.000001",
    "long_funding_rate_hourly": "0.000125",
    "short_funding_rate_hourly": "-0.000075",
    "long_funding_rate_annual": "1.095",
    "short_funding_rate_annual": "-0.657",
    "long_oi": "2500000.00",
    "short_oi": "1800000.00",
    "total_oi": "4300000.00",
    "skew": "0.1628",
    "volumeUsd24h": "45000000.00",
    "volumeUsdTotal": "2340000000.00"
  }
  ```
</ResponseExample>

## Overview

Get detailed open interest breakdown for a specific trading market. Open Interest (OI) represents the total value of outstanding positions and is a key indicator of market activity, liquidity, and directional bias. Strike Protocol tracks OI separately for long and short positions, providing insights into market sentiment and potential price movements.

<Note>
  This endpoint does NOT require authentication and provides real-time open interest data for all users.
</Note>

## Path Parameters

<ParamField path="symbol" type="string" required>
  Trading pair symbol to get open interest for.

  **Supported values**: "BTC-USD", "ETH-USD", "SOL-USD"\
  **Example**: "BTC-USD"
</ParamField>

## Response Fields

<ResponseField name="symbol" type="string">
  Trading pair identifier that was queried
</ResponseField>

<ResponseField name="longOI" type="string">
  Total USD value of long positions in the market
</ResponseField>

<ResponseField name="shortOI" type="string">
  Total USD value of short positions in the market
</ResponseField>

<ResponseField name="totalOI" type="string">
  Combined open interest (longOI + shortOI)
</ResponseField>

<ResponseField name="imbalance" type="string">
  Open interest imbalance percentage showing directional bias

  * **Positive**: More long than short positions (long-heavy)
  * **Negative**: More short than long positions (short-heavy)
  * **Near zero**: Balanced market
</ResponseField>

## Open Interest Mechanics

### What Open Interest Represents

#### Position Value

Open Interest measures the total USD value of all outstanding positions:

* **Long OI**: Sum of all long position sizes
* **Short OI**: Sum of all short position sizes
* **Total OI**: Combined exposure in the market

#### Market Activity

OI provides insights into:

* **Market engagement**: Higher OI = more active participation
* **Liquidity depth**: More positions = more potential liquidity
* **Capital allocation**: Where traders are putting their money
* **Market maturity**: Established markets tend to have higher OI

### Imbalance Calculation

```
Imbalance % = ((Long OI - Short OI) / Total OI) × 100
```

#### Interpretation Examples

**Long-Heavy Market**:

```
Long OI: $2,500,000
Short OI: $1,800,000
Total OI: $4,300,000
Imbalance: +16.28% (long-heavy)
```

**Short-Heavy Market**:

```
Long OI: $1,200,000  
Short OI: $2,100,000
Total OI: $3,300,000
Imbalance: -27.27% (short-heavy)
```

**Balanced Market**:

```
Long OI: $1,500,000
Short OI: $1,450,000
Total OI: $2,950,000
Imbalance: +1.69% (nearly balanced)
```

### Market Implications

#### Directional Bias

* **+20% to +50%**: Moderate bullish bias
* **+50%+**: Strong bullish sentiment
* **-20% to -50%**: Moderate bearish bias
* **-50%-**: Strong bearish sentiment
* **±10%**: Balanced, no clear directional bias

#### Funding Impact

OI imbalance directly affects funding rates:

* **Long-heavy**: Longs typically pay funding to shorts
* **Short-heavy**: Shorts typically pay funding to longs
* **Balanced**: Minimal funding rate pressure

#### Volatility Indicators

* **High total OI**: Potential for significant price moves when positions close
* **Extreme imbalance**: Risk of cascading liquidations
* **Growing OI**: Increasing market interest and potential volatility

## Error Responses

<ResponseField name="400 Bad Request" type="object">
  Invalid symbol parameter

  ```json theme={null}
  {
    "error": 400,
    "message": "Invalid symbol: XYZ-USD"
  }
  ```
</ResponseField>

<ResponseField name="404 Not Found" type="object">
  Symbol not found or not supported

  ```json theme={null}
  {
    "error": 404,
    "message": "Market not found: ABC-USD"
  }
  ```
</ResponseField>

## Related Endpoints

* **[Get Markets](/api-reference/market-data/markets)** - View OI for all markets at once
* **[Get Funding Rates](/api-reference/market-data/funding-rates)** - Understand how OI imbalance affects funding
* **[Get Positions](/api-reference/positions/get-positions)** - See your contribution to market OI
* **[Long Position](/api-reference/trading/long)** / **[Short Position](/api-reference/trading/short)** - Your trades affect total OI

<Tip>
  Use OI data to identify market opportunities and risks. Extreme imbalances often precede significant price movements, while balanced OI suggests stable, liquid markets.
</Tip>

<Warning>
  Extreme OI imbalances can lead to cascading liquidations and high volatility. Exercise caution when trading in markets with >40% imbalance.
</Warning>