Code Examples

Ready-to-run examples for Python, JavaScript, and curl. Replace zk_your_key with your actual API key.

1. Fetch HIGH/CRITICAL Signals

Python

import requests

API_KEY = "zk_your_key"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get("https://api.zctechnologies.org/v1/signals", headers=HEADERS)
data = resp.json()
for filing in data["data"]:
    print(f"[{filing['max_urgency_label']}] {filing['company']} -- {filing['filed']}")
    for item_num, item in filing["items"].items():
        print(f"  Item {item_num}: {item['name']}")
print(f"\n{data['count']} signal(s) found")

JavaScript / Node.js

const res = await fetch('https://api.zctechnologies.org/v1/signals', {
  headers: { Authorization: 'Bearer zk_your_key' }
});
const data = await res.json();
data.data.forEach(f => {
  console.log(`[${f.max_urgency_label}] ${f.company} -- ${f.filed}`);
  Object.entries(f.items).forEach(([num, item]) =>
    console.log(`  Item ${num}: ${item.name}`)
  );
});
console.log(`${data.count} signal(s) found`);

curl

curl https://api.zctechnologies.org/v1/signals \
  -H "Authorization: Bearer zk_your_key" | jq '.data[] | {company, max_urgency_label, filed}'

2. Monitor a Specific Company (NVIDIA)

Python

import requests

HEADERS = {"Authorization": "Bearer zk_your_key"}
resp = requests.get("https://api.zctechnologies.org/v1/company/1045810", headers=HEADERS)
data = resp.json()
print(f"{data['name']} ({', '.join(data['tickers'])}): {data['count']} recent 8-Ks")
for f in data["recent_8ks"][:5]:
    print(f"  {f['filed']} -- {f['form']} -- {f['accession']}")

curl

curl https://api.zctechnologies.org/v1/company/1045810 -H "Authorization: Bearer zk_your_key"

3. Deep-Dive a Single Filing

Python

import requests

HEADERS = {"Authorization": "Bearer zk_your_key"}
resp = requests.get(
    "https://api.zctechnologies.org/v1/filings/0001193125-26-142364",
    params={"cik": "1920145"}, headers=HEADERS
)
filing = resp.json()
print(f"Urgency: {filing['max_urgency_label']}")
print(f"Dollar amounts: {filing['dollar_amounts']}")
for num, item in filing["items"].items():
    print(f"\nItem {num}: {item['name']} [{item['urgency_label']}]")
    print(f"  {item['context'][:200]}...")

curl

curl "https://api.zctechnologies.org/v1/filings/0001193125-26-142364?cik=1920145" \
  -H "Authorization: Bearer zk_your_key"

4. Real-Time Alert Loop (Python)

import requests, time, sys

HEADERS = {"Authorization": "Bearer zk_your_key"}
seen = set()

def check_signals():
    resp = requests.get("https://api.zctechnologies.org/v1/signals", headers=HEADERS, timeout=10)
    for filing in resp.json()["data"]:
        key = filing["accession"]
        if key not in seen and filing["max_urgency"] >= 4:
            seen.add(key)
            print(f"CRITICAL: {filing['company']} filed {filing['accession']}")
            for num, item in filing["items"].items():
                if item["urgency"] >= 4:
                    print(f"  Item {num}: {item['name']}")

while True:
    try:
        check_signals()
    except Exception as e:
        print(f"Error: {e}", file=sys.stderr)
    time.sleep(30)

5. Free Preview (No Auth)

curl https://api.zctechnologies.org/v1/filings/recent
# Returns 5 filings. No API key needed.

Get Your API Key   Full Docs