Crypto Perpetual Long/Short Ratio History (by Exchange & Pair)

omnial/exchange-long-short-ratio

Given a trading pair and an exchange, returns a historical time series of the long/short ratio for perpetual futures traders on that exchange -- a single number per time bucket showing whether traders were net long (above 1) or net short (below 1) at that point.

activeper callv3

Price

Up to $0.00819 per call; you pay what the call used

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.

Data source

Binance, OKX, Bybit and Bitget

Data from the exchange you select: Binance by default, or OKX, Bybit or Bitget.

Use it

Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.

Connect once and your AI can find and run this tool, and any other it needs.

Install it Create an account

For developers: the calls your assistant makes

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/exchange-long-short-ratio" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/exchange-long-short-ratio" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/exchange-long-short-ratio", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/exchange-long-short-ratio", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.00819

Updated: Oct 27, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "pair"
  ],
  "properties": {
    "from": {
      "type": "string",
      "minLength": 1,
      "description": "Start of time range. Accepts Unix seconds or date string (YYYY-MM-DD, ISO8601). Binance only retains the last 30 days of data; other exchanges may have different limits. Example: 2026-03-01."
    },
    "pair": {
      "type": "string",
      "minLength": 1,
      "description": "Trading pair (e.g. BTC/USDT). Example: BTC/USDT."
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 500,
      "minimum": 1,
      "description": "Max number of records. For longer history, paginate using the last returned timestamp as the next from value. Example: 50. Defaults to 50."
    },
    "exchange": {
      "enum": [
        "binance",
        "okx",
        "bybit",
        "bitget"
      ],
      "type": "string",
      "default": "binance",
      "description": "Exchange identifier. Example: binance. Defaults to \"binance\"."
    },
    "interval": {
      "enum": [
        "1h",
        "4h",
        "1d"
      ],
      "type": "string",
      "default": "1h",
      "description": "Bucket size for each point in the series: 1h, 4h, or 1d. This endpoint uses interval only; it does NOT accept time_range. Use from + limit to control the window. Example: 1h. Defaults to \"1h\"."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "pair": {
            "type": "string",
            "description": "The trading pair as requested, e.g. 'BTC/USDT'."
          },
          "exchange": {
            "type": "string",
            "description": "Echoes the requested exchange, e.g. 'binance', 'okx'."
          },
          "timestamp": {
            "type": "integer",
            "description": "Unix seconds marking the start of this bucket."
          },
          "long_short_ratio": {
            "type": "number",
            "description": "Ratio of long to short positions/traders at this bucket. Above 1 means more long than short; below 1 means more short than long. E.g. 1.07-1.33 (BTC/USDT hourly, binance) and 1.15-1.49 (ETH/USDT daily, okx) in testing."
          }
        },
        "additionalProperties": false
      },
      "description": "One entry per time bucket."
    },
    "meta": {
      "type": "object",
      "properties": {
        "cached": {
          "type": "boolean",
          "description": "Whether this response was served from the provider's cache. Typically false."
        }
      },
      "additionalProperties": false
    }
  },
  "description": "The long/short ratio response.",
  "additionalProperties": false
}