Skip to main content

Install

pip install artemis==0.1.1

Setup

export ARTEMIS_API_KEY="your_key_here"

Example: Fetch Spot Volume for Kalshi and Polymarket

from artemis import Artemis

client = Artemis()  # reads ARTEMIS_API_KEY from env

response = client.fetch_metrics(
    metric_names="spot_volume",
    symbols="kalshi,polymarket",
    start_date="2026-03-01",
    end_date="2026-03-27",
)

data = response.model_dump()
for platform in ["kalshi", "polymarket"]:
    daily = data["data"]["symbols"][platform]["spot_volume"]
    total = sum(d["val"] for d in daily if d["val"])
    print(f"{platform}: ${total/1e6:,.0f}M total volume")

Response Format

Each platform returns an array of {date, val} objects:
{
  "data": {
    "symbols": {
      "kalshi": {
        "spot_volume": [
          {"date": "2026-03-20", "val": 520619009.0},
          {"date": "2026-03-21", "val": 502850870.0}
        ]
      },
      "polymarket": {
        "spot_volume": [
          {"date": "2026-03-20", "val": 336191967.57},
          {"date": "2026-03-21", "val": 368044996.98}
        ]
      }
    }
  }
}

Fetching Multiple Metrics

response = client.fetch_metrics(
    metric_names="spot_volume,open_interest,spot_dau",
    symbols="kalshi,polymarket,opinion",
    start_date="2026-03-01",
    end_date="2026-03-27",
)

Available Prediction Market Symbols

SymbolPlatform
kalshiKalshi
polymarketPolymarket
opinionOpinion
driftDrift

Available Metrics

MetricDescription
spot_volumeDaily trading volume
open_interestOpen interest
spot_txnsTransaction count
spot_dauDaily active users
feesProtocol fees
tvlTotal value locked

More Information