# TeleSint — Telegram Threat Intelligence API ## What This API Does TeleSint monitors public Telegram threat intelligence channels in real time, extracts IOCs, C2 infrastructure, threat actor activity, breach announcements, and early attack intent signals. All records are AI-enriched by DeepSeek with MITRE ATT&CK technique tagging, confidence scoring (0-100), TLP classification, and structured JSON output. Pay per call in USDC on Base mainnet via x402. No API key. No account. No subscription. ## Base URL https://telesint.daligence.com ## Authentication x402 micropayment protocol. Include a valid payment-signature header with each request. Payment: USDC on Base mainnet (eip155:8453). Facilitator: CDP (api.cdp.coinbase.com). ## Errors are not charged (changed 31 October 2026) A paid call that cannot give a result returns an HTTP error, and x402 does not settle it: - 400 — parameters missing or invalid (guidance JSON with error + hint) - 404 — the record or watchlist does not exist - 503 — an internal or upstream failure; retry later The body is JSON with "error" and "charged": false. Before this date these came back as HTTP 200 and were charged. If your client reads the "error" field of 200 responses, also handle 4xx and 5xx. Over A2A the query now runs before settlement: an error is answered and not charged. Results, including empty results, are still 200 and charged. ## MCP (Model Context Protocol) Endpoint: https://telesint.daligence.com/mcp (Streamable HTTP, protocol 2026-07-28; 2025-03-26..2025-11-25 clients also accepted) Server card: https://telesint.daligence.com/mcp/server-card Every paid endpoint below is exposed as an MCP tool (tool name = OpenAPI operationId, e.g. getIoc, getPreparation), same price. Payment uses the x402 MCP transport: an unpaid tools/call returns isError:true with an x402 PaymentRequired object (structuredContent + content[0].text). Sign it with any x402 client and retry the identical call with the payload in params._meta["x402/payment"]. The settlement receipt is returned in result._meta["x402/payment-response"]. Watchlist tools (watchCreate, watchPull, watchList, watchDelete) work over MCP: the paying wallet is the account. --- ## Endpoints ### GET /ioc — Indicators of Compromise ($0.01 USDC) Returns defanged IOCs extracted from Telegram: IP addresses, domains, URLs, file hashes, CVEs. **Query parameters:** - type (string, optional) — ip | domain | url | md5 | sha1 | sha256 | cve - severity (string, optional) — critical | high | medium | low | info (returns this level and above) - min_confidence (number, optional) — integer 0-100, filters by AI confidence score - since (string, optional) — ISO 8601 timestamp, e.g. 2026-05-01T00:00:00Z - tlp (string, optional) — WHITE | GREEN | AMBER | RED - tag (string, optional) — tag keyword, e.g. ransomware, cobalt-strike, apt - channel (string, optional) — partial match on source Telegram channel name - kev (string, optional) — true = only records whose CVEs are in the CISA KEV catalog - provenance (string, optional) — observed (actor-side claim/sale/announcement) | reported (researcher/vendor/news) | unknown - include_probation (string, optional) — true to include records from channels still on probation (default: hidden; included records carry trust:"probation") - claim_type (string, optional) — announcement | claim | sale | recruitment | propaganda | report - limit (number, optional) — page size, default 20, max 100 - offset (number, optional) — pagination offset, default 0 **Response fields:** - source (string) — "TeleSint" - endpoint (string) — "ioc" - total (number) — total matching records - items[] (array) — list of IOC records - id (string) — record id (16 hex characters) - channel (string) — defanged source Telegram URL - ts (string) — ISO 8601 timestamp - category (string) — "ioc" - summary (string) — AI-generated summary of the raw message - iocs[] (array) — extracted indicators - type (string) — ip | domain | url | md5 | sha1 | sha256 | cve - value (string) — defanged indicator value - context (string) — usage context from the source message - ttps[] (array) — MITRE ATT&CK techniques - id (string) — e.g. T1566.001 - name (string) — technique name - tactic (string) — tactic name - confidence (number) — AI confidence score 0-100 - severity (string) — critical | high | medium | low | info - tlp (string) — WHITE | GREEN | AMBER | RED - tags[] (array) — string keywords - claim_type (string|null) — announcement | claim | sale | recruitment | propaganda | report - ioc_validation (object) — { validated, kev, malicious, provenance[], items[] } - items[] — { type, value (defanged), provenance, kev?: {date_added, ransomware_use}, nvd?: {cvss, severity, published}, benign? } - validated=false means the record's IOCs have not been checked yet (usually minutes after ingestion) - _attribution[] (array) — required source notices, e.g. the NVD notice when NVD data is included **Example call:** GET https://telesint.daligence.com/ioc?type=ip&severity=high&limit=10 GET https://telesint.daligence.com/ioc?type=cve&kev=true&provenance=observed --- ### GET /c2 — C2 Infrastructure ($0.02 USDC) Returns Command-and-Control infrastructure: panels, listeners, beacons, malleable profiles. **Query parameters:** - framework (string, optional) — cobalt_strike | sliver | havoc | brute_ratel | metasploit - severity (string, optional) — critical | high | medium | low | info - min_confidence (number, optional) — 0-100 - since (string, optional) — ISO 8601 timestamp - tag (string, optional) — tag keyword - limit (number, optional) — default 20, max 100 - offset (number, optional) — default 0 **Example call:** GET https://telesint.daligence.com/c2?framework=cobalt_strike&severity=high --- ### GET /actor — Threat Actor Profiles ($0.02 USDC) Returns threat actor profiles with TTPs, attribution, targets, and motivation. **Query parameters:** - name (string, optional) — actor name or alias, partial match (e.g. lazarus, sandworm) - nation_state (string, optional) — ISO country code or name: kp | ru | cn | ir | us - motivation (string, optional) — financial | espionage | hacktivism | sabotage - ttp (string, optional) — MITRE ATT&CK ID prefix, e.g. T1059 - severity (string, optional) — critical | high | medium | low | info - limit (number, optional) — default 20, max 100 - offset (number, optional) — default 0 **Example call:** GET https://telesint.daligence.com/actor?nation_state=ru&motivation=espionage --- ### GET /breach — Breach & Data Leak Disclosures ($0.03 USDC) Returns breach announcements and credential leak disclosures from Telegram. **Query parameters:** - sector (string, optional) — targeted sector keyword: finance | healthcare | government | energy - country (string, optional) — targeted country keyword: us | uk | de | fr - organization (string, optional) — organization name partial match - severity (string, optional) — critical | high | medium | low | info - min_confidence (number, optional) — 0-100 - since (string, optional) — ISO 8601 timestamp - limit (number, optional) — default 20, max 100 - offset (number, optional) — default 0 **Example call:** GET https://telesint.daligence.com/breach?sector=finance&country=us&severity=high --- ### GET /ransomware — Ransomware Intelligence ($0.04 USDC) Returns ransomware group victim posts, leak site announcements, extortion demands, and group activity (LockBit, BlackCat, Cl0p, RansomHub, Play, Akira, Black Basta, etc.). **Query parameters:** - severity (string, optional) — critical | high | medium | low | info - min_confidence (number, optional) — 0-100 - since (string, optional) — ISO 8601 timestamp - tag (string, optional) — ransomware group tag, e.g. lockbit | blackcat | cl0p | ransomhub | play | akira - sector (string, optional) — targeted sector keyword - country (string, optional) — targeted country keyword - organization (string, optional) — targeted organization partial match - limit (number, optional) — default 20, max 100 - offset (number, optional) — default 0 **Example call:** GET https://telesint.daligence.com/ransomware?tag=lockbit§or=finance --- ### GET /malware — Malware Family Intelligence ($0.02 USDC) Returns malware family analysis: new sample drops, behavior descriptions, packer/loader details, malware-as-a-service offerings. **Query parameters:** - severity (string, optional) — critical | high | medium | low | info - min_confidence (number, optional) — 0-100 - since (string, optional) — ISO 8601 timestamp - tag (string, optional) — malware type: stealer | loader | rat | backdoor | botnet | dropper | rootkit - ttp (string, optional) — MITRE ATT&CK ID prefix - limit (number, optional) — default 20, max 100 - offset (number, optional) — default 0 **Example call:** GET https://telesint.daligence.com/malware?tag=stealer&severity=high --- ### GET /darkweb — Dark Web Intelligence ($0.03 USDC) Returns dark web marketplace listings, underground forum chatter, access broker posts, credential shops, and Tor site activity sourced from Telegram monitoring. **Query parameters:** - severity (string, optional) — critical | high | medium | low | info - min_confidence (number, optional) — 0-100 - since (string, optional) — ISO 8601 timestamp - tag (string, optional) — access-broker | credential-shop | combo-list | carding | forum | marketplace - sector (string, optional) — targeted sector keyword - country (string, optional) — targeted country keyword - organization (string, optional) — targeted organization partial match - limit (number, optional) — default 20, max 100 - offset (number, optional) — default 0 **Example call:** GET https://telesint.daligence.com/darkweb?tag=access-broker§or=healthcare --- ### GET /vulnerability — CVE & Exploitation Intelligence ($0.03 USDC) Returns CVEs and exploitation-in-the-wild signals from Telegram CTI channels. **Query parameters:** - severity (string, optional) — critical | high | medium | low | info - min_confidence (number, optional) — 0-100 - since (string, optional) — ISO 8601 timestamp - tag (string, optional) — cve | exploit | poc | patch | zero-day - type (string, optional) — cve (filters to CVE-type IOCs only) - kev (string, optional) — true = only CVEs in the CISA Known Exploited Vulnerabilities catalog - claim_type (string, optional) — report | claim | sale | announcement (e.g. sale = exploit offered for sale) Returns every record that carries a CVE. Each item's ioc_validation adds CISA KEV membership (with known ransomware use) and the NVD CVSS score where available. - ttp (string, optional) — MITRE ATT&CK ID prefix, e.g. T1190 - limit (number, optional) — default 20, max 100 - offset (number, optional) — default 0 **Example call:** GET https://telesint.daligence.com/vulnerability?severity=critical&tag=poc --- ### GET /search — Cross-Category Pivot Search ($0.04 USDC) Searches across all intel categories in a single call. **Query parameters:** - q (string, optional) — broad keyword: searches tags and summaries (e.g. lockbit, lazarus) - category (string, optional) — narrow to one: ioc | c2 | actor | breach | intent | vulnerability - severity (string, optional) — critical | high | medium | low | info - sector (string, optional) — targeted sector keyword - country (string, optional) — targeted country keyword - organization (string, optional) — organization name partial match - tag (string, optional) — tag keyword filter - ttp (string, optional) — MITRE ATT&CK ID prefix - name (string, optional) — actor name partial match - min_confidence (number, optional) — 0-100 - since (string, optional) — ISO 8601 timestamp - limit (number, optional) — default 20, max 100 - offset (number, optional) — default 0 **Example call:** GET https://telesint.daligence.com/search?q=lockbit§or=finance&severity=high --- ### GET /intent — Early Attack Intent Signals ($0.05 USDC) Returns pre-attack signals: targeting announcements, initial access sales, 0day disclosures, ransomware group recruitment, and exploit kit availability. **Query parameters:** - sector (string, optional) — targeted sector: finance | healthcare | government | energy | retail - country (string, optional) — targeted country - organization (string, optional) — targeted organization partial match - intent_type (string, optional) — access_sale | 0day | ransomware | exploit | recruitment - claim_type (string, optional) — announcement (future attack) | claim (completed) | sale | recruitment | propaganda | report - limit (number, optional) — default 20, max 100 - offset (number, optional) — default 0 **Example call:** GET https://telesint.daligence.com/intent?sector=healthcare&intent_type=ransomware --- ### GET /feed — Full Threat Intel Feed ($0.05 USDC) Returns the unified feed across all categories. **Query parameters:** - category (string, optional) — ioc | c2 | actor | breach | intent - severity (string, optional) — critical | high | medium | low | info - min_confidence (number, optional) — 0-100 - since (string, optional) — ISO 8601 timestamp - tag (string, optional) — tag keyword - tlp (string, optional) — WHITE | GREEN | AMBER | RED - limit (number, optional) — default 20, max 100 - offset (number, optional) — default 0 **Example call:** GET https://telesint.daligence.com/feed?since=2026-05-27T00:00:00Z&severity=high&limit=50 --- ### GET /artifact — CTI Artifact Export ($0.05 USDC) Converts a stored TeleSint record into an operational artifact. - sigma — Sigma-compatible YAML detection rule - stix — STIX 2.1 JSON bundle - report — Structured analyst report **Query parameters:** - id (string, required) — record id from items[].id (16 hex characters; UUIDs also accepted) - format (string, required) — sigma | stix | report - envelope (string, optional) — json: sigma/report text inside a signed JSON body (field `artifact`). Plain text (the default) is not signed; stix is always signed JSON. **Example call:** GET https://telesint.daligence.com/artifact?id=4e472bfb52bfd864&format=sigma&envelope=json --- ### GET /asn — ASN Threat Intelligence ($0.03 USDC) Profiles an Autonomous System Number using Telegram CTI channel data. **Query parameters:** - asn (string, required) — ASN identifier e.g. AS215540 | AS9009 | AS14061 - org (string, optional) — org name fragment for lookup **Example call:** GET https://telesint.daligence.com/asn?asn=AS215540 --- ### GET /status — Operational Metrics (FREE) Returns system health, monitored channel count, ingestion freshness, and per-category record counts. No payment required. **Example call:** GET https://telesint.daligence.com/status --- ### GET /source — Raw Source Verification ($0.02 USDC) Returns the original defanged Telegram message for a given record id. **Query parameters:** - id (string, required) — record id from any endpoint's items[].id field (16 hex characters; UUIDs also accepted) - include_raw (string, optional) — "true" (default) | "false" **Example call:** GET https://telesint.daligence.com/source?id=f8a3c1d2-4b5e-4f6a-9c8d-1e2f3a4b5c6d --- ## Adversary Intent Endpoints (deterministic — no LLM in the decision path) You cannot observe intent directly; you can observe PREPARATION (MITRE ATT&CK TA0042 Resource Development, TA0043 Reconnaissance). These endpoints score it. Telegram only shows actors who prepare noisily (criminals, access brokers, hacktivists): a low score is NOT evidence of safety against camouflaged state actors. ### GET /preparation — Adversary Preparation Assessment ($0.10 USDC) Call before an escalation decision. Pass at least one of: - organization (string) — target organisation (most specific) - sector (string) — e.g. energy | healthcare | finance | government - country (string) — country or region: UAE | KSA | US | GCC | MENA | Europe - actor (string) — threat actor or group - vendor (string) — technology vendor in the target stack (use this, not organization, for Microsoft/Fortinet/Siemens…) - window (string) — lookback days 7-90, default 30 Returns: verdict (escalate | watch | none) + reasons, stage_reached and gaps[] across five stages (motive, capability, infrastructure, recon, access), per-stage count/velocity/evidence IDs, fusion { bel_targeted, pl_targeted, bel_opportunistic, conflict_k, conflict_flag, families_converging }, sub_scores { alpha_specificity, beta_infrastructure_persistence, gamma_operational_context }, claimed_compromise (ransomware/breach claims, reported separately), evidence[], _methodology, _caveats. Example: GET https://telesint.daligence.com/preparation?organization=Acme+Energy§or=energy&country=UAE ### GET /velocity — Threat Activity Velocity ($0.03 USDC) Optional scope: organization | sector | country | actor | vendor; window (default 30). Returns trend per stage and per category: accelerating | new | flat | decelerating. Example: GET https://telesint.daligence.com/velocity?sector=healthcare ### GET /target-mentions — Organisation Mentions ($0.05 USDC) - organization (string, required); sector, country, window (default 90) optional Returns deduplicated records naming the organisation, kinds { access_or_credentials, targeting_announcements, compromise_claims }, first/last seen, record IDs. Example: GET https://telesint.daligence.com/target-mentions?organization=Acme+Energy ### GET /claim-check — Claim Recycling Check ($0.05 USDC) - id (string) — TeleSint record id, OR text (string, ≤4000 chars); victim (optional) Returns verdict recycled | reused_template | previously_claimed | repost | no_prior_match | insufficient_signal, matches[] with ages and similarity. Screenshots are not compared yet (images are not stored). Example: GET https://telesint.daligence.com/claim-check?id=8fdfdbf91592209c ### Watchlists — the paying wallet is the account - GET /watch/create ($0.02) — organizations (comma list, max 5), sector, country, actor, vendor, keywords, window → watch_id - GET /watch/pull ($0.10) — watch_id → new records since last pull (pir_match scored), verdict per target with transitions, alerts[] - GET /watch/list ($0.01) — this wallet's watchlists - GET /watch/delete ($0.01) — watch_id Only the wallet that paid for /watch/create can pull, list or delete it. ### Response signing When enabled, every paid JSON response carries _provenance { signer, digest, signature }: RFC 8785 canonical JSON → SHA-256 → EIP-191 signature from a dedicated key (not the payment wallet). Details: https://telesint.daligence.com/.well-known/telesint-signer.json --- ## Pricing Summary | Endpoint | Price | Best for | |-----------------|---------|---------------------------------------------| | /ioc | $0.01 | IOC enrichment, blocklist generation | | /c2 | $0.02 | Network defense, firewall rules | | /actor | $0.02 | Attribution, threat modeling | | /malware | $0.02 | Malware family tracking, sandbox triage | | /breach | $0.03 | Breach monitoring (non-ransomware) | | /vulnerability | $0.03 | CVE tracking, patch prioritization | | /darkweb | $0.03 | Underground forum and access broker intel | | /asn | $0.03 | ASN C2 hosting, bulletproof infra, phishing kit pivot | | /search | $0.04 | Ad-hoc pivot across all categories | | /ransomware | $0.04 | Ransomware group activity, victim tracking | | /intent | $0.05 | Proactive defense, early warning | | /feed | $0.05 | Full pipeline ingestion | | /artifact | $0.05 | Sigma rules, STIX bundles, analyst reports | | /source | $0.02 | Raw source provenance, translation verify | | /preparation | $0.10 | Pre-attack verdict for an org/sector/country | | /velocity | $0.03 | Tempo change detection on a schedule | | /target-mentions| $0.05 | Is this organisation being named? | | /claim-check | $0.05 | Is this claim recycled? | | /watch/create | $0.02 | Wallet-bound watchlist | | /watch/pull | $0.10 | What changed since my last pull | | /watch/list | $0.01 | List this wallet's watchlists | | /watch/delete | $0.01 | Remove a watchlist | | /status | FREE | Freshness check before committing spend |