market.get_data

Retrieve detailed market data including orderbook depth, trade history, and metadata.

---

Overview

The market.get_data tool fetches comprehensive market information for analysis and decision-making. Use this for detailed market research before opening positions.

---

Parameters

Parameter	Type	Required	Description
market_id	string	Yes	Platform-specific market identifier
platform	string	Yes	"polymarket" or "kalshi"
include_orderbook	boolean	No	Include orderbook data (default: true)
include_trades	boolean	No	Include recent trades (default: true)
orderbook_depth	number	No	Number of price levels (default: 10)
trades_limit	number	No	Number of recent trades (default: 50)

---

Request Example

result = agent.run("""
  Get detailed data for presidential election market
  on Polymarket including orderbook and recent trades
""")

---

Response Format

{
  "market_id": "0x1a2b3c...",
  "platform": "polymarket",
  "title": "Presidential Election 2024",
  "description": "...",
  "category": "politics",
  "current_probability": 0.47,
  "liquidity": 5200000,
  "volume_24h": 850000,
  "volume_total": 12500000,
  "orderbook": {
    "bids": [
      {"price": 0.46, "size": 25000},
      {"price": 0.45, "size": 32000}
    ],
    "asks": [
      {"price": 0.48, "size": 18000},
      {"price": 0.49, "size": 28000}
    ],
    "spread": 0.02,
    "mid_price": 0.47
  },
  "recent_trades": [
    {
      "timestamp": "2026-03-19T14:30:00Z",
      "side": "BUY",
      "price": 0.47,
      "size": 500,
      "total": 235
    }
  ],
  "metadata": {
    "created_at": "2023-06-15T00:00:00Z",
    "close_date": "2024-11-05T23:59:59Z",
    "resolution_source": "Associated Press",
    "tags": ["politics", "election", "presidential"]
  }
}

---

Related Tools

• market.search - Find markets

• position.open - Open positions