{"openapi":"3.0.3","info":{"title":"TeleSint","version":"1.0.0","description":"Real-time cyber threat intelligence sourced from public Telegram CTI channels. Pay-per-call endpoints covering IOC extraction (IPs, domains, hashes, CVEs), C2 infrastructure lookup, threat actor profiles, breach disclosures, pre-attack intent signals, vulnerability and exploitation-in-the-wild tracking, ransomware group activity, malware family intelligence, dark web monitoring, cross-category keyword search, a unified threat feed, and deterministic adversary-preparation scoring (pre-attack verdicts, activity velocity, organisation mentions, claim recycling checks and wallet-bound watchlists). All records are AI-enriched by DeepSeek with MITRE ATT&CK technique tagging, confidence scoring (0-100), TLP classification, and structured JSON output. No API key — USDC micropayments on Base mainnet via x402.","contact":{"name":"TeleSint API","email":"senwan.ops+telesint@proton.me"},"x-logo":{"url":"https://telesint.daligence.com/icon.png","altText":"TeleSint"},"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"}},"servers":[{"url":"https://telesint.daligence.com","description":"TeleSint — production"}],"x-skill-url":"https://telesint.daligence.com/SKILL.md","x-a2a-url":"https://telesint.daligence.com/a2a","x-mcp-url":"https://telesint.daligence.com/mcp","paths":{"/ioc":{"get":{"summary":"Indicators of Compromise","description":"Defanged IOCs from Telegram CTI channels: IPs, domains, URLs, file hashes, CVEs. Filterable by type, severity, confidence, sector, and timestamp.","operationId":"getIoc","tags":["IOC","Threat Intel"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["ip","domain","url","md5","sha1","sha256","cve"]},"description":"IOC type filter"},{"name":"kev","in":"query","required":false,"schema":{"type":"string","enum":["true"]},"description":"Only records whose CVEs are in the CISA KEV catalog"},{"name":"provenance","in":"query","required":false,"schema":{"type":"string","enum":["observed","reported","unknown"]},"description":"IOC provenance: observed in actor activity, or reported by researchers/vendors/news"},{"name":"include_probation","in":"query","required":false,"schema":{"type":"string","enum":["true","false"]},"description":"Records from channels still on probation (auto-promoted within the last 14 days, not yet trusted) are hidden by default. Pass true to include them; each carries trust:\"probation\"."},{"name":"claim_type","in":"query","required":false,"schema":{"type":"string","enum":["announcement","claim","sale","recruitment","propaganda","report"]},"description":"What the message does: announcement (future attack), claim (completed), sale, recruitment, propaganda, report"},{"name":"severity","in":"query","required":false,"schema":{"type":"string"},"description":"Minimum severity: critical | high | medium | low | info"},{"name":"min_confidence","in":"query","required":false,"schema":{"type":"integer"},"description":"Minimum AI confidence score 0-100"},{"name":"since","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 timestamp filter"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"Page size, default 20, max 100"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0},"description":"Pagination offset"}],"responses":{"200":{"description":"IOC feed"},"402":{"description":"Payment required — x402 USDC on Base mainnet"}}}},"/c2":{"get":{"summary":"C2 Infrastructure Lookup","description":"Active command-and-control servers and frameworks from Telegram CTI. Returns C2 IPs, domains, frameworks (Cobalt Strike, Metasploit, Sliver), and associated threat actors.","operationId":"getC2","tags":["C2","Infrastructure"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"parameters":[{"name":"framework","in":"query","required":false,"schema":{"type":"string"},"description":"C2 framework filter e.g. cobalt-strike, sliver, metasploit"},{"name":"severity","in":"query","required":false,"schema":{"type":"string"},"description":"Minimum severity"},{"name":"min_confidence","in":"query","required":false,"schema":{"type":"integer"},"description":"Minimum confidence 0-100"},{"name":"since","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 timestamp filter"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0},"description":"Pagination offset"}],"responses":{"200":{"description":"C2 infrastructure list"},"402":{"description":"Payment required"}}}},"/actor":{"get":{"summary":"Threat Actor Profiles","description":"Threat actor intelligence from Telegram CTI channels. Returns actor aliases, attributed nation-state, targeted sectors, TTPs, associated malware, and recent campaign activity.","operationId":"getActor","tags":["Threat Actor","APT"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"parameters":[{"name":"name","in":"query","required":false,"schema":{"type":"string"},"description":"Actor name partial match e.g. lazarus, sandworm, lockbit"},{"name":"sector","in":"query","required":false,"schema":{"type":"string"},"description":"Targeted sector e.g. finance, healthcare, energy"},{"name":"min_confidence","in":"query","required":false,"schema":{"type":"integer"},"description":"Minimum confidence 0-100"},{"name":"since","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 timestamp filter"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0},"description":"Pagination offset"}],"responses":{"200":{"description":"Threat actor profiles"},"402":{"description":"Payment required"}}}},"/breach":{"get":{"summary":"Breach Disclosures","description":"Leaked credentials and data dumps from Telegram CTI channels. Returns organization name, data types exposed, record count, leak source, and associated threat actors.","operationId":"getBreach","tags":["Breach","Data Leak"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.03"}},"parameters":[{"name":"sector","in":"query","required":false,"schema":{"type":"string"},"description":"Target sector e.g. finance, healthcare, government"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"Target country e.g. us, uk, de"},{"name":"organization","in":"query","required":false,"schema":{"type":"string"},"description":"Organization name partial match"},{"name":"severity","in":"query","required":false,"schema":{"type":"string"},"description":"Minimum severity"},{"name":"since","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 timestamp filter"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0},"description":"Pagination offset"}],"responses":{"200":{"description":"Breach disclosures"},"402":{"description":"Payment required"}}}},"/vulnerability":{"get":{"summary":"Vulnerability and Exploitation Intelligence","description":"CVEs and exploitation-in-the-wild reports from Telegram CTI. Returns CVE IDs, CVSS scores, PoC availability, affected products, and active exploitation context.","operationId":"getVulnerability","tags":["Vulnerability","CVE"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.03"}},"parameters":[{"name":"severity","in":"query","required":false,"schema":{"type":"string"},"description":"Minimum severity: critical | high | medium | low"},{"name":"min_confidence","in":"query","required":false,"schema":{"type":"integer"},"description":"Minimum confidence 0-100"},{"name":"since","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 timestamp filter"},{"name":"tag","in":"query","required":false,"schema":{"type":"string"},"description":"Tag filter e.g. cve, exploit, poc, zero-day"},{"name":"kev","in":"query","required":false,"schema":{"type":"string","enum":["true"]},"description":"Only records whose CVEs are in the CISA KEV catalog"},{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Free-text keyword, e.g. a vendor or product name"},{"name":"claim_type","in":"query","required":false,"schema":{"type":"string","enum":["announcement","claim","sale","recruitment","propaganda","report"]},"description":"What the message does: announcement (future attack), claim (completed), sale, recruitment, propaganda, report"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0},"description":"Pagination offset"}],"responses":{"200":{"description":"Vulnerability intelligence"},"402":{"description":"Payment required"}}}},"/darkweb":{"get":{"summary":"Dark Web Monitoring","description":"Dark web marketplace and forum activity from Telegram CTI channels. Returns listings, access broker posts, leaked data announcements, and ransomware negotiation signals.","operationId":"getDarkweb","tags":["Dark Web","Underground"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.03"}},"parameters":[{"name":"sector","in":"query","required":false,"schema":{"type":"string"},"description":"Target sector filter"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"Target country filter"},{"name":"severity","in":"query","required":false,"schema":{"type":"string"},"description":"Minimum severity"},{"name":"since","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 timestamp filter"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0},"description":"Pagination offset"}],"responses":{"200":{"description":"Dark web activity"},"402":{"description":"Payment required"}}}},"/search":{"get":{"summary":"Cross-Category CTI Search","description":"Pivot across all TeleSint intel categories with a single query. Accepts keyword search plus filters: category, severity, sector, country, actor name, TTP, tag, confidence. Returns unified items[] across any category.","operationId":"getSearch","tags":["Search","Pivot"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.04"}},"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Keyword search across tags and summaries e.g. lockbit, lazarus, cve-2026"},{"name":"category","in":"query","required":false,"schema":{"type":"string"},"description":"Narrow to one category: ioc | c2 | actor | breach | intent | vulnerability"},{"name":"severity","in":"query","required":false,"schema":{"type":"string"},"description":"Minimum severity"},{"name":"sector","in":"query","required":false,"schema":{"type":"string"},"description":"Target sector"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"Target country"},{"name":"min_confidence","in":"query","required":false,"schema":{"type":"integer"},"description":"Minimum confidence 0-100"},{"name":"since","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 timestamp filter"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0},"description":"Pagination offset"}],"responses":{"200":{"description":"Cross-category search results"},"402":{"description":"Payment required"}}}},"/ransomware":{"get":{"summary":"Ransomware Group Activity","description":"Ransomware group victim posts and activity from Telegram CTI. Returns group name, victim organization, sector, country, data volume, ransom demand, and leak timeline.","operationId":"getRansomware","tags":["Ransomware","Extortion"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.04"}},"parameters":[{"name":"group","in":"query","required":false,"schema":{"type":"string"},"description":"Ransomware group name e.g. lockbit, blackcat, clop"},{"name":"sector","in":"query","required":false,"schema":{"type":"string"},"description":"Target sector"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"Target country"},{"name":"severity","in":"query","required":false,"schema":{"type":"string"},"description":"Minimum severity"},{"name":"since","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 timestamp filter"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0},"description":"Pagination offset"}],"responses":{"200":{"description":"Ransomware activity"},"402":{"description":"Payment required"}}}},"/intent":{"get":{"summary":"Pre-Attack Intent Signals","description":"Early warning signals from threat actor chatter on Telegram. Detects target reconnaissance, vulnerability scanning announcements, and attack planning discussions before incidents occur.","operationId":"getIntent","tags":["Intent","Early Warning"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"parameters":[{"name":"sector","in":"query","required":false,"schema":{"type":"string"},"description":"Target sector filter"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"Target country filter"},{"name":"claim_type","in":"query","required":false,"schema":{"type":"string","enum":["announcement","claim","sale","recruitment","propaganda","report"]},"description":"What the message does: announcement (future attack), claim (completed), sale, recruitment, propaganda, report"},{"name":"severity","in":"query","required":false,"schema":{"type":"string"},"description":"Minimum severity"},{"name":"min_confidence","in":"query","required":false,"schema":{"type":"integer"},"description":"Minimum confidence 0-100"},{"name":"since","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 timestamp filter"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0},"description":"Pagination offset"}],"responses":{"200":{"description":"Intent signals"},"402":{"description":"Payment required"}}}},"/malware":{"get":{"summary":"Malware Family Intelligence","description":"Malware family profiles and samples from Telegram CTI. Returns malware name, family, capabilities, C2 patterns, associated threat actors, and file hashes.","operationId":"getMalware","tags":["Malware"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"parameters":[{"name":"name","in":"query","required":false,"schema":{"type":"string"},"description":"Malware name partial match e.g. cobalt-strike, qakbot, emotet"},{"name":"severity","in":"query","required":false,"schema":{"type":"string"},"description":"Minimum severity"},{"name":"min_confidence","in":"query","required":false,"schema":{"type":"integer"},"description":"Minimum confidence 0-100"},{"name":"since","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 timestamp filter"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0},"description":"Pagination offset"}],"responses":{"200":{"description":"Malware intelligence"},"402":{"description":"Payment required"}}}},"/feed":{"get":{"summary":"Unified Threat Intelligence Feed","description":"Full unified feed of all TeleSint intel categories in one call. Sorted by timestamp descending. Useful for SIEM ingestion, threat dashboards, and monitoring agents that need the complete picture.","operationId":"getFeed","tags":["Feed","Unified"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"parameters":[{"name":"severity","in":"query","required":false,"schema":{"type":"string"},"description":"Minimum severity filter"},{"name":"min_confidence","in":"query","required":false,"schema":{"type":"integer"},"description":"Minimum confidence 0-100"},{"name":"since","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 timestamp filter"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0},"description":"Pagination offset"}],"responses":{"200":{"description":"Unified threat feed"},"402":{"description":"Payment required"}}}},"/artifact":{"get":{"summary":"CTI Artifact Export","description":"Export a TeleSint intel record as a Sigma detection rule, STIX 2.1 bundle, or structured analyst report. Requires the record id (from any endpoint's items[].id) and a format. All output is derived from real enriched fields — no synthetic data.","operationId":"getArtifact","tags":["Artifact","Export"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"description":"Intel record id from items[].id in any TeleSint response (16 hex characters; UUIDs also accepted)"},{"name":"format","in":"query","required":true,"schema":{"type":"string","enum":["sigma","stix","report"]},"description":"Output format: sigma | stix | report"},{"name":"envelope","in":"query","required":false,"schema":{"type":"string","enum":["json"]},"description":"json = sigma/report text inside a signed JSON body (field artifact); default plain text is not signed"}],"responses":{"200":{"description":"Artifact in requested format"},"400":{"description":"Missing or invalid parameters"},"402":{"description":"Payment required — x402 USDC on Base mainnet"},"404":{"description":"Record not found"}}}},"/asn":{"get":{"summary":"ASN Threat Intelligence","description":"Profiles an Autonomous System Number (ASN) using Telegram CTI channel observations. Returns C2 framework associations, phishing kit links, threat actor mentions, bulletproof hosting indicators, and blocking recommendation with WAF rule hint.","operationId":"getAsn","tags":["ASN","Infrastructure"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.03"}},"parameters":[{"name":"asn","in":"query","required":true,"schema":{"type":"string"},"description":"ASN identifier e.g. AS215540, AS9009, AS14061"},{"name":"org","in":"query","required":false,"schema":{"type":"string"},"description":"Optional org name fragment e.g. hivelocity, digitalocean, m247"}],"responses":{"200":{"description":"ASN threat intelligence profile"},"402":{"description":"Payment required — x402 USDC on Base mainnet"}}}},"/status":{"get":{"summary":"Operational Metrics & Channel Directory","description":"Returns system health, monitored channel count, ingestion freshness, and per-category record counts. Free endpoint — no payment required.","operationId":"getStatus","tags":["Status","Discovery"],"parameters":[],"responses":{"200":{"description":"Operational metrics and channel directory"}}}},"/source":{"get":{"summary":"Raw Source Verification & Translation","description":"Returns the original defanged Telegram message for a given record id alongside its AI-generated English summary. For Tier-2/3 SOC provenance checks and legal forensics.","operationId":"getSource","tags":["Provenance","Verification"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"description":"Record id from any TeleSint endpoint items[].id (16 hex characters; UUIDs also accepted)"},{"name":"include_raw","in":"query","required":false,"schema":{"type":"string","default":"true"},"description":"Include original raw_text (defanged). Default: true"}],"responses":{"200":{"description":"Source record with raw text and provenance metadata"},"400":{"description":"Missing id parameter"},"402":{"description":"Payment required — x402 USDC on Base mainnet"},"404":{"description":"Record not found"}}}},"/preparation":{"get":{"summary":"Adversary Preparation Assessment","description":"Is someone preparing to attack this organisation, sector or country? Five-stage ladder (motive, capability, infrastructure, recon, access) with gaps, Dempster-Shafer fusion of independent signal families (belief, plausibility, conflict), EWMA velocity per stage and a deterministic verdict escalate | watch | none. No LLM in the decision path.","operationId":"getPreparation","tags":["Intent","Early Warning"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.10"}},"parameters":[{"name":"organization","in":"query","required":false,"schema":{"type":"string"},"description":"Target organisation name"},{"name":"sector","in":"query","required":false,"schema":{"type":"string"},"description":"Target sector e.g. energy, healthcare"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"Country or region e.g. UAE, KSA, US, GCC"},{"name":"actor","in":"query","required":false,"schema":{"type":"string"},"description":"Threat actor or group"},{"name":"vendor","in":"query","required":false,"schema":{"type":"string"},"description":"Technology vendor in the target stack"},{"name":"window","in":"query","required":false,"schema":{"type":"string"},"description":"Lookback days 7-90, default 30"}],"responses":{"200":{"description":"JSON result"},"400":{"description":"Guidance JSON (error + hint): parameters missing or invalid. Not charged."},"402":{"description":"Payment required — x402 USDC on Base mainnet"},"503":{"description":"Assessment failed; retry later. Not charged."}}}},"/velocity":{"get":{"summary":"Threat Activity Velocity","description":"Acceleration of Telegram threat activity per preparation stage and per category, globally or for a scope. Window counts, EWMA level and trend accelerating | new | flat | decelerating.","operationId":"getVelocity","tags":["Intent","Monitoring"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.03"}},"parameters":[{"name":"organization","in":"query","required":false,"schema":{"type":"string"},"description":"Target organisation name"},{"name":"sector","in":"query","required":false,"schema":{"type":"string"},"description":"Target sector e.g. energy, healthcare"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"Country or region e.g. UAE, KSA, US, GCC"},{"name":"actor","in":"query","required":false,"schema":{"type":"string"},"description":"Threat actor or group"},{"name":"vendor","in":"query","required":false,"schema":{"type":"string"},"description":"Technology vendor in the target stack"},{"name":"window","in":"query","required":false,"schema":{"type":"string"},"description":"Lookback days 7-90, default 30"}],"responses":{"200":{"description":"JSON result"},"400":{"description":"Guidance JSON (error + hint): parameters missing or invalid. Not charged."},"402":{"description":"Payment required — x402 USDC on Base mainnet"},"503":{"description":"Assessment failed; retry later. Not charged."}}}},"/target-mentions":{"get":{"summary":"Organisation Mentions","description":"Every deduplicated Telegram record naming an organisation: access sales, credential leaks, targeting announcements and compromise claims, with specificity, first/last seen and record IDs.","operationId":"getTargetMentions","tags":["Intent","Attack Surface"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"parameters":[{"name":"organization","in":"query","required":true,"schema":{"type":"string"},"description":"Organisation name"},{"name":"sector","in":"query","required":false,"schema":{"type":"string"},"description":"Optional sector context"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"Optional country context"},{"name":"window","in":"query","required":false,"schema":{"type":"string"},"description":"Lookback days 7-90, default 90"}],"responses":{"200":{"description":"JSON result"},"400":{"description":"Guidance JSON (error + hint): parameters missing or invalid. Not charged."},"402":{"description":"Payment required — x402 USDC on Base mainnet"},"503":{"description":"Assessment failed; retry later. Not charged."}}}},"/claim-check":{"get":{"summary":"Claim Recycling Check","description":"Tests a breach, ransomware or hacktivist claim for recycling against earlier Telegram records using victim keys, word-shingle similarity and strong-IOC overlap. Verdict recycled | reused_template | previously_claimed | repost | no_prior_match.","operationId":"getClaimCheck","tags":["Intent","Verification"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"parameters":[{"name":"id","in":"query","required":false,"schema":{"type":"string"},"description":"TeleSint record id"},{"name":"text","in":"query","required":false,"schema":{"type":"string"},"description":"Claim text, max 4000 chars"},{"name":"victim","in":"query","required":false,"schema":{"type":"string"},"description":"Optional victim organisation or domain"}],"responses":{"200":{"description":"JSON result"},"400":{"description":"Guidance JSON (error + hint): parameters missing or invalid. Not charged."},"402":{"description":"Payment required — x402 USDC on Base mainnet"},"503":{"description":"Assessment failed; retry later. Not charged."}}}},"/watch/create":{"get":{"summary":"Create Watchlist","description":"Creates a watchlist owned by the paying wallet (no account). Returns watch_id.","operationId":"watchCreate","tags":["Watchlist"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"parameters":[{"name":"organizations","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated, max 5"},{"name":"sector","in":"query","required":false,"schema":{"type":"string"},"description":"Sector"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"Country or region"},{"name":"actor","in":"query","required":false,"schema":{"type":"string"},"description":"Actor"},{"name":"vendor","in":"query","required":false,"schema":{"type":"string"},"description":"Vendor"},{"name":"keywords","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated, max 10"},{"name":"window","in":"query","required":false,"schema":{"type":"string"},"description":"Preparation window 7-90 days"}],"responses":{"200":{"description":"JSON result"},"400":{"description":"Guidance JSON (error + hint): parameters missing or invalid. Not charged."},"402":{"description":"Payment required — x402 USDC on Base mainnet"},"503":{"description":"Assessment failed; retry later. Not charged."}}}},"/watch/pull":{"get":{"summary":"Pull Watchlist","description":"Records ingested since the last pull scored by requirement match, preparation verdict per target with transitions, and alerts. Only the creating wallet can pull.","operationId":"watchPull","tags":["Watchlist"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.10"}},"parameters":[{"name":"watch_id","in":"query","required":true,"schema":{"type":"string"},"description":"UUID from /watch/create"}],"responses":{"200":{"description":"JSON result"},"400":{"description":"Guidance JSON (error + hint): parameters missing or invalid. Not charged."},"402":{"description":"Payment required — x402 USDC on Base mainnet"},"503":{"description":"Assessment failed; retry later. Not charged."}}}},"/watch/list":{"get":{"summary":"List Watchlists","description":"Watchlists owned by the paying wallet.","operationId":"watchList","tags":["Watchlist"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"parameters":[],"responses":{"200":{"description":"JSON result"},"400":{"description":"Guidance JSON (error + hint): parameters missing or invalid. Not charged."},"402":{"description":"Payment required — x402 USDC on Base mainnet"},"503":{"description":"Assessment failed; retry later. Not charged."}}}},"/watch/delete":{"get":{"summary":"Delete Watchlist","description":"Deactivates a watchlist owned by the paying wallet.","operationId":"watchDelete","tags":["Watchlist"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"parameters":[{"name":"watch_id","in":"query","required":true,"schema":{"type":"string"},"description":"UUID from /watch/create"}],"responses":{"200":{"description":"JSON result"},"400":{"description":"Guidance JSON (error + hint): parameters missing or invalid. Not charged."},"402":{"description":"Payment required — x402 USDC on Base mainnet"},"503":{"description":"Assessment failed; retry later. Not charged."}}}}}}