Everything you need to call the TASI API.

X-API-Key: tasi_live_xxxxxxxxxxxxxxxx_yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy
Content-Type: application/json

curl -s "https://api.tasi-api.com/api/v1/market/status" \
  -H "X-API-Key: $TASI_API_KEY"

{
  "status": "open",
  "phase": "continuous",
  "realtime_connected": true,
  "execution_open": true,
  "last_snapshot_at": "2026-10-18T10:31:07.412Z",
  "timezone": "Asia/Riyadh",
  "session": {
    "date": "2026-10-18",
    "status": "open",
    "opens_at": "2026-10-18T07:00:00Z",
    "continuous_closes_at": "2026-10-18T12:00:00Z",
    "trade_at_last_ends_at": "2026-10-18T12:20:00Z",
    "calendar_override": false
  }
}

curl -s "https://api.tasi-api.com/api/v1/market/calendar?from=2026-10-18&to=2026-10-22" \
  -H "X-API-Key: $TASI_API_KEY"

curl -s "https://api.tasi-api.com/api/v1/instruments" \
  -H "X-API-Key: $TASI_API_KEY" | jq '.data[:2]'

{
  "data": [
    { "symbol": "1120", "name_en": "Al Rajhi Bank", "kind": "stock",
      "active": true, "sector_code": "BAN" }
  ],
  "count": 1
}

curl -s "https://api.tasi-api.com/api/v1/quotes?symbols=2222,1120,TASI" \
  -H "X-API-Key: $TASI_API_KEY"

{
  "data": [
    {
      "symbol": "2222",
      "captured_at": "2026-10-18T10:31:07.412Z",
      "last": 26.90, "bid": 26.88, "ask": 26.92,
      "volume_day": 12345678, "value_day": 332000000,
      "open": 26.55, "change": 0.35, "change_percent": 1.32,
      "name_en": "Saudi Arabian Oil Co."
    }
  ],
  "count": 1, "limit": 20, "requested": 3
}

import os, requests

API = "https://api.tasi-api.com/api/v1"
KEY = os.environ["TASI_API_KEY"]

r = requests.get(
    f"{API}/quotes",
    params={"symbols": "2222,1120,2010,TASI"},
    headers={"X-API-Key": KEY},
    timeout=10,
)
r.raise_for_status()

for q in r.json()["data"]:
    print(q["symbol"], q["last"], q.get("change_percent"))

const API = "https://api.tasi-api.com/api/v1";

const res = await fetch(`${API}/quotes?symbols=2222,1120`, {
  headers: { "X-API-Key": process.env.TASI_API_KEY },
});

if (!res.ok) {
  const body = await res.json();
  throw new Error(body.error.message);
}

const { data } = await res.json();
console.table(data.map(({ symbol, last, change_percent }) => ({ symbol, last, change_percent })));

import os, time, requests

API = "https://api.tasi-api.com/api/v1"
H = {"X-API-Key": os.environ["TASI_API_KEY"]}

while True:
    s = requests.get(f"{API}/market/status", headers=H, timeout=10).json()
    if s["execution_open"]:
        quotes = requests.get(
            f"{API}/quotes", params={"symbols": "2222,1120"}, headers=H, timeout=10
        ).json()["data"]
        for q in quotes:
            print(q["symbol"], q["last"], q["captured_at"])
        time.sleep(10)
    else:
        print("market closed:", s["phase"])
        time.sleep(60)

curl -s "https://api.tasi-api.com/api/v1/instruments" \
  -H "X-API-Key: $TASI_API_KEY" \
  | jq -r '.data[] | select(.name_en | test("bank";"i")) | "\(.symbol)\t\(.name_en)"'

curl -s "https://api.tasi-api.com/api/v1/paper/portfolio" \
  -H "X-API-Key: $PAPER_KEY"

{
  "portfolio": { "id": "…", "name": "Alpha", "currency": "SAR",
                 "opening_balance": "100000.0000", "cash_balance": "100000.0000" },
  "summary": { "equity": "100000.0000", "market_value": "0.0000",
               "total_pnl": "0.0000", "return_pct": "0.0000" }
}

curl -s -X POST "https://api.tasi-api.com/api/v1/paper/portfolio/orders" \
  -H "X-API-Key: $PAPER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"2222","side":"buy","order_type":"market","quantity":"10"}'

curl -s -X POST "https://api.tasi-api.com/api/v1/paper/portfolio/orders" \
  -H "X-API-Key: $PAPER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"1120","side":"buy","order_type":"limit","quantity":"20","limit_price":"64.00"}'

curl -s "https://api.tasi-api.com/api/v1/paper/portfolio/positions" -H "X-API-Key: $PAPER_KEY"
curl -s "https://api.tasi-api.com/api/v1/paper/portfolio/orders"    -H "X-API-Key: $PAPER_KEY"

{ "error": { "code": "stale_quote",
             "message": "The latest market snapshot is too old for a simulated market order." } }

wss://api.tasi-api.com/api/v1/ws

{
  "type": "quote",
  "data": {
    "symbol": "2222",
    "sequence": "1792917214818277600",
    "captured_at": "2026-10-25T08:33:34.818277Z",
    "last": 25.18, "bid": 25.16, "ask": 25.20,
    "volume_day": 2426281, "value_day": 61296937,
    "change": -0.26, "change_percent": -1.02,
    "name_en": "Saudi Arabian Oil Co."
  }
}

import asyncio, json, os, websockets

async def main():
    headers = {"X-API-Key": os.environ["TASI_API_KEY"]}
    async with websockets.connect("wss://api.tasi-api.com/api/v1/ws",
                                  additional_headers=headers) as ws:
        print(json.loads(await ws.recv()))            # hello
        await ws.send(json.dumps({"type": "subscribe",
                                  "symbols": ["2222", "1120", "TASI"]}))
        async for raw in ws:
            msg = json.loads(raw)
            if msg["type"] == "quote":
                d = msg["data"]
                print(d["symbol"], d["last"], d["sequence"])
            else:
                print(msg)

asyncio.run(main())