Skip to content

Method - get_screener_densities

Returns ScreenerDensitiesSnapshotDto: bid/ask density rows from the ProfitForge screener, with optional filters.

If exchange + market are both set: enables that screener market if needed, pushes screener config to the account server, refreshes the screener session, then filters rows. The exchange must be supported for the ProfitForge screener.


Contract (arguments)

ArgumentRequiredDefaultNotes
displaySymbolnonullFilter one display symbol, e.g. BTCUSDT
exchangenonullIf set, market must also be set
marketnonullspot or futures
maxPerSideno200Cap per side, 1–2000

Response shape

Root: ScreenerDensitiesSnapshotDtoscreener_scope_config_synced, filter_exchange, filter_market_type, bids[], asks[]. Each row: side (bid / ask), symbol, exchange, market_type, price, price_level_volume, base_volume.


Example tools/call

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_screener_densities",
    "arguments": {
      "exchange": "Binance",
      "market": "futures",
      "maxPerSide": 50
    }
  }
}

Example success (fragment)

json
{
  "screener_scope_config_synced": true,
  "filter_exchange": "Binance",
  "filter_market_type": "Futures",
  "bids": [
    {
      "side": "bid",
      "symbol": "BTCUSDT",
      "exchange": "Binance",
      "market_type": "Futures",
      "price": 98000,
      "price_level_volume": 1234567,
      "base_volume": 12.34
    }
  ],
  "asks": []
}

← MCP overview