AL

AlienVault OTX

global API

AlienVault OTX

Type: threat
Module: AlienVaultOtx

Capabilities

IOC Lookup Pulse Subscriptions IP Reputation Domain Analysis File Hash Analysis Threat Correlation

Try AlienVault OTX

API Endpoint

Results

Overview

AlienVault OTX (Open Threat Exchange) is one of the world's largest open threat intelligence communities, with over 200,000 participants sharing indicators of compromise (IOCs) in near-real-time. Now part of AT&T Cybersecurity (and subsequently acquired by LevelBlue in 2024), OTX provides community-curated "pulses" -- collections of IOCs related to specific threats, campaigns, or threat actors. Each pulse contains multiple indicator types including IPs, domains, URLs, file hashes, and email addresses, along with human-authored narrative context describing the threat campaign, affected industries, and recommended mitigations.

The platform operates on a crowdsourced intelligence model where security researchers, SOC analysts, incident responders, and threat intelligence teams worldwide contribute observations from their environments. This community-driven approach ensures rapid indicator sharing -- often within minutes of initial discovery -- providing significantly faster coverage than commercial threat feeds alone. OTX pulses frequently appear before formal advisories from vendors or government CERTs, making them a critical early-warning resource.

For threat intelligence analysts, OTX provides crowdsourced context around indicators that would otherwise be isolated data points. When investigating a suspicious IP or domain, OTX reveals whether it has been associated with known threat campaigns by the security community. The platform's strength lies in the volume and diversity of its contributors: nation-state threat researchers, malware analysts, fraud investigators, and network defenders all contribute indicators from their specialized vantage points, creating a composite view of the threat landscape that no single organization could achieve alone.

OTX supports the STIX (Structured Threat Information eXpression) and TAXII (Trusted Automated eXchange of Indicator Information) standards, enabling automated ingestion into existing security infrastructure. The DirectConnect SDK provides native integration libraries for Python, Go, and Java, while the REST API enables custom integrations in any language including Elixir.

Data Sources and Coverage

AlienVault OTX aggregates threat intelligence from multiple source categories, each contributing different types of indicators and contextual information.

Community Contributions

The primary data source is the global community of 200,000+ participants. Contributors submit pulses through the web interface, API, or DirectConnect SDK. Each pulse undergoes community validation through a reputation system that weights contributor credibility based on historical accuracy, volume, and community engagement. High-reputation contributors' pulses receive elevated visibility and faster propagation.

Automated Collection

OTX operates automated collection infrastructure including honeypots, DNS sinkholes, malware sandboxes, and network sensors deployed globally. These systems generate machine-observed indicators that supplement human contributions, particularly for infrastructure indicators (IP addresses, domains) and malware hashes.

Partner Feeds

Integration partnerships with security vendors, ISPs, and national CERTs provide additional indicator streams. These partner-sourced indicators often carry higher confidence levels due to professional vetting processes.

Coverage Statistics

MetricApproximate Volume
Total Pulses4,000,000+
Active Contributors200,000+
Daily New Indicators50,000-100,000
Indicator Types15+ (IPv4, IPv6, domain, hostname, URL, URI, FileHash-MD5, FileHash-SHA1, FileHash-SHA256, email, CVE, CIDR, mutex, YARA, hostname)
Geographic CoverageGlobal (190+ countries represented)
Threat CategoriesAPT, crimeware, ransomware, phishing, DDoS, botnets, exploit kits, C2 infrastructure

API Integration

Authentication and Base URL

OTX provides a comprehensive REST API accessible at https://otx.alienvault.com/api/v1/. Authentication requires a free API key obtained through account registration. The API key is passed via the X-OTX-API-KEY HTTP header.

API Endpoints

EndpointMethodDescription
/api/v1/pulses/subscribedGETRetrieve pulses from subscribed feeds
/api/v1/pulses/activityGETRecent pulse activity across the platform
/api/v1/indicators/IPv4/{ip}/generalGETGeneral information about an IPv4 address
/api/v1/indicators/domain/{domain}/generalGETGeneral domain information
/api/v1/indicators/hostname/{hostname}/generalGETHostname indicator details
/api/v1/indicators/file/{hash}/generalGETFile hash indicator analysis
/api/v1/indicators/url/{url}/generalGETURL indicator details
/api/v1/indicators/CVE/{cve}/generalGETCVE-related threat intelligence
/api/v1/search/pulsesGETSearch pulses by keyword
/api/v1/pulses/createPOSTSubmit a new pulse

Rate Limits

TierRate LimitCost
Free10,000 requests/hour$0
OTX DirectConnect10,000 requests/hour$0 (SDK)
Enterprise (LevelBlue)CustomContact sales

curl Examples

# Query IP reputation
curl -H "X-OTX-API-KEY: YOUR_API_KEY" \
  "https://otx.alienvault.com/api/v1/indicators/IPv4/8.8.8.8/general"

# Search pulses by keyword
curl -H "X-OTX-API-KEY: YOUR_API_KEY" \
  "https://otx.alienvault.com/api/v1/search/pulses?q=ransomware&page=1"

# Get subscribed pulse indicators (modified since timestamp)
curl -H "X-OTX-API-KEY: YOUR_API_KEY" \
  "https://otx.alienvault.com/api/v1/pulses/subscribed?modified_since=2025-01-01T00:00:00"

# Domain analysis with full details
curl -H "X-OTX-API-KEY: YOUR_API_KEY" \
  "https://otx.alienvault.com/api/v1/indicators/domain/example.com/general"

# File hash lookup
curl -H "X-OTX-API-KEY: YOUR_API_KEY" \
  "https://otx.alienvault.com/api/v1/indicators/file/d41d8cd98f00b204e9800998ecf8427e/general"

Query Examples

Elixir API Integration

# Search for threat pulses related to a campaign
{:ok, pulses} = AlienVaultOtx.search_pulses("APT29", page: 1, limit: 50)

# Lookup IP reputation with full indicator context
{:ok, ip_intel} = AlienVaultOtx.ip_lookup("192.168.1.1")
# => %{
#   reputation: 42,
#   pulse_count: 7,
#   country: "RU",
#   asn: "AS12345",
#   malware_families: ["Cobalt Strike", "Mimikatz"],
#   threat_categories: [:apt, :c2_infrastructure]
# }

# Domain indicator query
{:ok, domain_intel} = AlienVaultOtx.domain_lookup("suspicious-domain.com")

# File hash analysis
{:ok, hash_intel} = AlienVaultOtx.file_hash_lookup(
  "e3b0c44298fc1c149afbf4c8996fb924",
  hash_type: :md5
)

# Bulk indicator submission (contributing back to community)
{:ok, pulse} = AlienVaultOtx.create_pulse(%{
  name: "Phishing Campaign Targeting Financial Sector",
  description: "Observed phishing campaign using lookalike domains",
  indicators: [
    %{type: "domain", value: "login-bankexample.com"},
    %{type: "IPv4", value: "203.0.113.42"},
    %{type: "URL", value: "https://login-bankexample.com/auth"}
  ],
  tags: ["phishing", "financial", "credential-harvesting"],
  tlp: "white"
})

# Subscribe to pulses from a specific user
{:ok, _} = AlienVaultOtx.subscribe("AlienVault")

# Get subscribed pulse updates since last sync
{:ok, updates} = AlienVaultOtx.get_subscribed_pulses(
  modified_since: ~U[2025-01-01 00:00:00Z]
)

Data Schema

Pulse Structure

%AlienVaultOtx.Pulse{
  id: "pulse_id_string",
  name: "Campaign Name",
  description: "Detailed threat narrative...",
  author_name: "researcher_handle",
  created: ~U[2025-06-15 14:30:00Z],
  modified: ~U[2025-06-16 09:15:00Z],
  tags: ["apt29", "cozy-bear", "phishing"],
  tlp: "white",
  adversary: "APT29",
  targeted_countries: ["US", "DE", "CZ"],
  industries: ["government", "defense"],
  malware_families: ["WellMess", "WellMail"],
  attack_ids: [
    %{id: "T1566", name: "Phishing", source: "MITRE ATT&CK"}
  ],
  references: ["https://example.com/advisory"],
  indicators: [
    %{id: 1, type: "IPv4", indicator: "203.0.113.42", title: "C2 Server",
      description: "Command and control infrastructure", role: "c2"},
    %{id: 2, type: "domain", indicator: "malware-update.example.com",
      title: "Payload delivery domain", role: "delivery"},
    %{id: 3, type: "FileHash-SHA256",
      indicator: "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
      title: "Dropper hash", role: "malware_sample"}
  ],
  pulse_source: "api",
  revision: 3
}

Indicator Response Fields

FieldTypeDescription
indicatorstringThe indicator value (IP, domain, hash, etc.)
typestringIndicator type identifier
pulse_info.countintegerNumber of pulses referencing this indicator
pulse_info.pulseslistSummary of associated pulses
reputationintegerReputation score (0-100, higher = more malicious)
country_codestringISO country code for IP indicators
asnstringAutonomous System Number for IP indicators
validationlistCommunity validation results
sectionslistAvailable detail sections for the indicator

Use Cases

Threat Hunt Enrichment

When threat hunters identify suspicious indicators during proactive hunting operations, OTX provides immediate context. A single IP address query reveals associated threat campaigns, malware families, MITRE ATT&CK techniques, and related infrastructure -- transforming an isolated observation into actionable intelligence that guides further investigation.

Automated Threat Feed Integration

Security operations centers integrate OTX pulse subscriptions into SIEM platforms and firewall rule generation workflows. The STIX/TAXII endpoints enable standardized ingestion, while the DirectConnect SDK provides language-specific integration for custom automation. Indicators flow automatically from OTX into detection rules, blocklists, and alerting pipelines.

Incident Response Indicator Triage

During incident response operations, responders need rapid context on observed indicators. OTX's sub-second query response times enable real-time triage of IPs, domains, and file hashes discovered during forensic analysis. The community-contributed narratives provide immediate operational context that would otherwise require hours of manual research.

Campaign Tracking and Attribution

OTX pulses provide structured campaign tracking with adversary attribution, targeted industries, geographic focus, and evolution over time. Analysts can subscribe to specific threat actors or campaigns and receive automated updates as new infrastructure and TTPs are discovered by the community.

Supply Chain Risk Monitoring

Organizations monitor their third-party ecosystem by querying OTX for indicators associated with vendors, partners, and service providers. Alerts on new pulses mentioning supply chain entities enable proactive risk management before compromises propagate.

Limitations

While OTX is an exceptionally valuable free resource, analysts should be aware of several limitations that affect its operational use.

False Positive Rate: Community-contributed indicators vary in quality. Some contributors submit indicators with insufficient vetting, leading to benign infrastructure being flagged as malicious. Always cross-validate OTX indicators against multiple sources before taking blocking actions.

Indicator Decay: IOCs have limited shelf life. IP addresses are reassigned, domains expire and are re-registered, and threat actors rotate infrastructure. OTX does not systematically retire stale indicators, requiring consumers to implement their own aging policies.

Attribution Confidence: Threat actor attributions in pulses reflect individual contributor assessments, not verified intelligence. Attribution claims should be treated as hypotheses requiring additional corroboration.

Coverage Bias: OTX's coverage reflects its contributor base, which skews toward English-speaking security communities. Threats primarily affecting non-Western regions may be underrepresented.

No SLA: As a free community service, OTX does not guarantee uptime, response times, or data completeness. Production security workflows should implement fallback mechanisms.

OTX operates under a community sharing model governed by the Traffic Light Protocol (TLP). Contributors designate the sharing scope of their pulses using TLP markings (WHITE, GREEN, AMBER, RED), and consumers must respect these designations. Most publicly accessible pulses are TLP:WHITE, meaning they can be freely shared and consumed.

When using OTX data for security operations, organizations should ensure that indicator lookups comply with their jurisdiction's data protection regulations. Querying indicators derived from breach data or monitoring employee activity may trigger privacy obligations under GDPR or local equivalents.

Contributing indicators to OTX requires care to avoid exposing sensitive information. Pulses should not contain internal hostnames, private IP ranges, or details that could reveal organizational security posture to adversaries. The principle of minimum necessary disclosure applies: share only the indicators and context needed for community defense.

Organizations operating in regulated industries should document their OTX usage as part of their threat intelligence program and ensure that automated blocking based on community indicators includes appropriate review mechanisms to prevent business disruption from false positives.

Integration with Prismatic Platform

Prismatic Platform integrates AlienVault OTX as a primary community threat intelligence source within the multi-source threat correlation engine. The integration operates across several dimensions.

Automated IOC Enrichment

When new indicators are discovered by any platform module -- whether through Prismatic Perimeter attack surface scanning, network monitoring, or manual investigation -- they are automatically queried against OTX. The enrichment pipeline runs asynchronously, adding pulse context, reputation scores, and campaign associations to the platform's unified indicator store.

# Automatic enrichment pipeline integration
defmodule Prismatic.ThreatIntel.OTXEnricher do
  @behaviour Prismatic.ThreatIntel.Enricher

  @impl true
  def enrich(%Indicator{type: :ipv4, value: ip}) do
    with {:ok, intel} <- AlienVaultOtx.ip_lookup(ip),
         {:ok, pulses} <- AlienVaultOtx.ip_pulses(ip) do
      {:ok, %EnrichmentResult{
        source: :alienvault_otx,
        reputation: intel.reputation,
        pulse_count: length(pulses),
        threat_categories: extract_categories(pulses),
        confidence: calculate_confidence(intel, pulses),
        raw_data: intel
      }}
    end
  end
end

Multi-Source Correlation

OTX indicators are correlated with data from VirusTotal, AbuseIPDB, GreyNoise, and other threat intelligence sources. The correlation engine identifies indicators that appear across multiple sources, elevating confidence levels for confirmed threats and flagging discrepancies for analyst review.

Continuous Feed Synchronization

The platform maintains persistent OTX pulse subscriptions, synchronizing new and updated indicators on a configurable schedule (default: every 15 minutes). Pulse updates trigger re-evaluation of all matching indicators in the platform's threat store, automatically updating risk assessments and alert states.

Best Practices

Implement Indicator Aging: Set expiration policies for OTX indicators based on type. IP indicators should age out within 30-90 days; domain indicators within 60-180 days; file hashes can persist longer as they are more stable identifiers.

Cross-Validate Before Blocking: Never block traffic based on a single OTX pulse. Require corroboration from at least one additional source before implementing blocking rules. This prevents false positive disruptions from low-quality community submissions.

Subscribe Selectively: Rather than consuming all public pulses, subscribe to specific high-reputation contributors and threat categories relevant to your organization's threat model. This reduces noise and improves signal quality.

Contribute Back: Organizations that consume OTX intelligence should contribute their own observations when possible. This strengthens the community and improves the contributor's reputation score, which in turn provides access to higher-quality intelligence.

Monitor Pulse Quality: Track the false positive rate of OTX indicators in your environment over time. Use this data to adjust confidence weightings and aging policies for OTX-sourced indicators.

Respect TLP Markings: Ensure automated systems propagate and enforce TLP designations from OTX pulses through downstream security tools. TLP:AMBER indicators should not be shared outside your organization without explicit permission.

  • VirusTotal - Multi-engine malware and URL analysis with complementary detection coverage
  • AbuseIPDB - IP abuse reporting and reputation for cross-validation
  • GreyNoise - Internet scanner identification to filter benign scanning noise
  • Pulsedive - Additional threat intelligence platform with risk scoring
  • ThreatFox - IOC sharing by abuse.ch with malware family focus
  • MITRE ATT&CK - TTP framework referenced in OTX pulse attack patterns
  • CIRCL - Luxembourg CERT with MISP integration for structured sharing

Connect & Contribute

Created by Tomáš Korcak (korczis) | Open Source under GHL