API Documentation

curl -H "X-API-Key: pk_your_key" https://stacksja.com/api/v1/public/stock/GK
curl -H "X-API-Key: pk_your_key" https://stacksja.com/api/v1/public/stock/GraceKennedy
curl -H "X-API-Key: pk_your_key" https://stacksja.com/api/v1/public/stock/Wisynco

{
  "symbol": "GK",
  "company_name": "GraceKennedy Limited",
  "market": "main",
  "trade_date": "2026-03-06",
  "closing_price": "72.20",
  "last_traded_price": "72.17",
  "price_change": "0.03",
  "change_percent": 0.04,
  "volume": "6,749",
  "closing_bid": "72.17",
  "closing_ask": "72.23",
  "todays_range": "72.17 - 72.24",
  "week_range_52": "67.01 - 75.00"
}

curl -H "X-API-Key: pk_your_key" "https://stacksja.com/api/v1/public/quote?name=First+Rock"
curl -H "X-API-Key: pk_your_key" "https://stacksja.com/api/v1/public/quote?name=Caribbean+Cement"

curl -H "X-API-Key: pk_your_key" "https://stacksja.com/api/v1/public/stocks?market=main"

curl -H "X-API-Key: pk_your_key" "https://stacksja.com/api/v1/public/stock/NCBFG/history?limit=90"

curl -H "X-API-Key: pk_your_key" "https://stacksja.com/api/v1/public/search?q=jamaica"

curl -H "X-API-Key: pk_your_key" "https://stacksja.com/api/v1/public/pe-ratios"

{
  "count": 35,
  "pe_ratios": [
    {
      "symbol": "JMMBGL",
      "company_name": "JMMB Group Limited",
      "pe_ratio": 5.2,
      "ttm_eps": 3.85,
      "shares_outstanding": 1920000000
    },
    ...
  ]
}

curl -H "X-API-Key: pk_your_key" "https://stacksja.com/api/v1/public/stock/GK/financials"

{
  "symbol": "GK",
  "company_name": "GraceKennedy Limited",
  "count": 3,
  "valuation": {
    "pe_ratio": 12.5,
    "ttm_eps": 5.78,
    "shares_outstanding": 995040000
  },
  "financials": [
    {
      "fiscal_year": 2025,
      "period_type": "Q3",
      "statement_type": "unaudited",
      "currency": "JMD",
      "periods": {
        "current": {
          "revenue": 120500000000,
          "gross_profit": 42000000000,
          "net_income": 8500000000,
          "total_assets": 350000000000,
          "total_equity": 95000000000,
          "eps_basic": 8.54
        },
        "comparative": {
          "revenue": 110200000000,
          "net_income": 7200000000
        }
      }
    }
  ]
}

curl "https://stacksja.com/api/v1/public/stock/GK/documents"

{
  "symbol": "GK",
  "company_name": "GraceKennedy Limited",
  "count": 4,
  "documents": [
    {
      "id": 42,
      "fiscal_year": 2025,
      "period_type": "Q3",
      "statement_type": "unaudited",
      "currency": "JMD",
      "filename": "GK-Q3-2025.pdf",
      "confirmed_at": "2026-03-01T12:00:00",
      "pdf_url": "/api/v1/public/documents/42/pdf"
    }
  ]
}

curl "https://stacksja.com/api/v1/public/documents/42/pdf" -o statement.pdf

curl -H "X-API-Key: pk_your_key" "https://stacksja.com/api/v1/public/stock/GK/directors"

{
  "symbol": "GK",
  "company_name": "GraceKennedy Limited",
  "directors": [
    {
      "id": 1,
      "name": "Prof. Gordon V. Shirley",
      "title": "Chairman",
      "director_type": "chairman",
      "appointed_date": "",
      "bio": ""
    }
  ],
  "shareholders": [
    {
      "shareholder_name": "GraceKennedy (Pension) Ltd",
      "shares_held": 109000000,
      "ownership_percent": 10.9,
      "shareholder_type": "institutional",
      "as_of_date": "2024-12-31"
    }
  ],
  "cross_board_connections": {
    "Prof. Gordon V. Shirley": [
      {
        "company_name": "Bank of Jamaica",
        "role": "Governor",
        "is_jse_listed": 0,
        "jse_symbol": ""
      }
    ]
  }
}

curl -X PATCH \
  -H "X-API-Key: pk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"bio": "20+ years in financial services...", "appointed_date": "2019-03-01"}' \
  "https://stacksja.com/api/v1/public/directors/1"

{
  "status": "updated",
  "director": {
    "id": 1,
    "symbol": "GK",
    "name": "Prof. Gordon V. Shirley",
    "title": "Chairman",
    "director_type": "chairman",
    "appointed_date": "2019-03-01",
    "bio": "20+ years in financial services..."
  }
}

const source = new EventSource(
  "https://stacksja.com/api/v1/public/stream?api_key=pk_your_key"
);

source.addEventListener("connected", (e) => {
  console.log("Stream active:", JSON.parse(e.data).message);
});

source.addEventListener("price_update", (e) => {
  const data = JSON.parse(e.data);
  for (const stock of data.stocks) {
    console.log(`${stock.symbol}: $${stock.last_traded_price} (${stock.change_percent}%)`);
  }
});

source.addEventListener("document_added", (e) => {
  const data = JSON.parse(e.data);
  console.log(`New statement: ${data.symbol} ${data.period_type} ${data.fiscal_year}`);
  console.log(`${data.line_items_count} line items:`, data.line_items);
});

source.addEventListener("director_updated", (e) => {
  const { director } = JSON.parse(e.data);
  console.log(`Director updated: ${director.name} @ ${director.symbol}`);
});

source.addEventListener("ownership_updated", (e) => {
  const data = JSON.parse(e.data);
  console.log(`${data.symbol}: ${data.directors.length} directors, ${data.shareholders.length} shareholders`);
});

source.addEventListener("news_updated", (e) => {
  const data = JSON.parse(e.data);
  console.log(`${data.new_articles} new articles`);
});

// Handle errors / reconnect
source.onerror = () => {
  console.log("Connection lost, auto-reconnecting...");
};

curl -N "https://stacksja.com/api/v1/public/stream?api_key=pk_your_key"

import requests
import json

resp = requests.get(
    "https://stacksja.com/api/v1/public/stream",
    params={"api_key": "pk_your_key"},
    stream=True,
    timeout=None,
)

event_type = None
for line in resp.iter_lines(decode_unicode=True):
    if not line:
        event_type = None
        continue
    if line.startswith("event: "):
        event_type = line[7:]
    elif line.startswith("data: "):
        payload = json.loads(line[6:])
        print(f"[{event_type}]", payload)

import EventSource from "eventsource";  // npm install eventsource

const source = new EventSource(
  "https://stacksja.com/api/v1/public/stream?api_key=pk_your_key"
);

source.addEventListener("price_update", (e) => {
  const data = JSON.parse(e.data);
  console.log(`${data.count} stocks updated`);
});

source.addEventListener("document_added", (e) => {
  const data = JSON.parse(e.data);
  console.log(`New: ${data.symbol} ${data.period_type} ${data.fiscal_year}`);
});

const source = new EventSource(
  "https://stacksja.com/api/v1/public/stream/GK?api_key=pk_your_key"
);

source.addEventListener("price_update", (e) => {
  const data = JSON.parse(e.data);
  // Only GK updates arrive here
  document.getElementById("price").textContent = data.stocks[0].last_traded_price;
});

source.addEventListener("document_added", (e) => {
  // New GK financial statement just published
  const data = JSON.parse(e.data);
  showNotification(`New ${data.statement_type} statement: ${data.period_type} ${data.fiscal_year}`);
});

source.addEventListener("director_updated", (e) => {
  // A GK director's info was updated
  const { director } = JSON.parse(e.data);
  updateDirectorCard(director);
});

import requests

API_KEY = "pk_your_key_here"
BASE = "https://stacksja.com/api/v1/public"
headers = {"X-API-Key": API_KEY}

# Get latest price for a stock
stock = requests.get(f"{BASE}/stock/GK", headers=headers).json()
print(f"{stock['symbol']}: ${stock['closing_price']}")

# Get all main market stocks
all_stocks = requests.get(f"{BASE}/stocks?market=main", headers=headers).json()
for s in all_stocks["stocks"]:
    print(f"  {s['symbol']}: ${s['closing_price']}")

# Get financial statements
financials = requests.get(f"{BASE}/stock/GK/financials", headers=headers).json()
for f in financials["financials"]:
    revenue = f["periods"]["current"].get("revenue", "N/A")
    print(f"  {f['period_type']} {f['fiscal_year']}: Revenue {revenue}")

# Update a director's bio
import json
resp = requests.patch(
    f"{BASE}/directors/1",
    headers={**headers, "Content-Type": "application/json"},
    data=json.dumps({"bio": "20+ years in financial services..."})
)
print(resp.json())

const API_KEY = "pk_your_key_here";
const BASE = "https://stacksja.com/api/v1/public";
const headers = { "X-API-Key": API_KEY };

// Fetch a stock
const res = await fetch(`${BASE}/stock/GK`, { headers });
const stock = await res.json();
console.log(`${stock.symbol}: $${stock.closing_price}`);

// Stream live updates (no polling!)
const stream = new EventSource(`${BASE}/stream?api_key=${API_KEY}`);
stream.addEventListener("price_update", (e) => {
  const data = JSON.parse(e.data);
  data.stocks.forEach(s => updatePrice(s.symbol, s.last_traded_price));
});

function getJSEPrice(symbol) {
  var url = "https://stacksja.com/api/v1/public/stock/" + symbol;
  var options = { headers: { "X-API-Key": "pk_your_key_here" } };
  var response = UrlFetchApp.fetch(url, options);
  var data = JSON.parse(response.getContentText());
  return parseFloat(data.closing_price);
}

// Use in a cell: =getJSEPrice("GK")

import requests
import json

# Connect once, receive all updates forever
resp = requests.get(
    "https://stacksja.com/api/v1/public/stream",
    params={"api_key": "pk_your_key"},
    stream=True,
    timeout=None,
)

event_type = None
for line in resp.iter_lines(decode_unicode=True):
    if not line:
        event_type = None
        continue
    if line.startswith(":"):
        continue  # keepalive comment
    if line.startswith("event: "):
        event_type = line[7:]
    elif line.startswith("data: "):
        payload = json.loads(line[6:])

        if event_type == "price_update":
            for s in payload["stocks"]:
                print(f"  {s['symbol']}: ${s['last_traded_price']}")

        elif event_type == "document_added":
            print(f"  New statement: {payload['symbol']} {payload['period_type']} {payload['fiscal_year']}")

        elif event_type == "director_updated":
            d = payload["director"]
            print(f"  Director: {d['name']} - {d.get('bio', '')[:50]}...")

        elif event_type == "news_updated":
            print(f"  {payload['new_articles']} new articles")