Skip to content

Liberty91LTD/cti-skills / skills/otx-api

otx-api

Verified

AlienVault OTX API reference. Community threat intelligence pulses and indicator lookups.

FileKindSize
SKILL.mdskill md2.5 KB
---
name: otx-api
description: AlienVault OTX API reference. Community threat intelligence pulses and indicator lookups.
user-invocable: false
metadata:
  version: 1.0.0
---

# AlienVault OTX API

## Base URL
`https://otx.alienvault.com/api/v1`

## Authentication
Header: `X-OTX-API-KEY: $OTX_API_KEY`

## Rate Limits
- 10,000 requests/hour

## Key Endpoints

### IPv4 Indicator
```bash
# General info
curl -s "https://otx.alienvault.com/api/v1/indicators/IPv4/{ip}/general" \
  -H "X-OTX-API-KEY: $OTX_API_KEY"

# Reputation
curl -s "https://otx.alienvault.com/api/v1/indicators/IPv4/{ip}/reputation" \
  -H "X-OTX-API-KEY: $OTX_API_KEY"

# Passive DNS
curl -s "https://otx.alienvault.com/api/v1/indicators/IPv4/{ip}/passive_dns" \
  -H "X-OTX-API-KEY: $OTX_API_KEY"

# Associated malware
curl -s "https://otx.alienvault.com/api/v1/indicators/IPv4/{ip}/malware" \
  -H "X-OTX-API-KEY: $OTX_API_KEY"
```

### Domain Indicator
```bash
curl -s "https://otx.alienvault.com/api/v1/indicators/domain/{domain}/general" \
  -H "X-OTX-API-KEY: $OTX_API_KEY"
```
Sections: `/general`, `/geo`, `/malware`, `/url_list`, `/passive_dns`, `/whois`

### File Hash Indicator
```bash
curl -s "https://otx.alienvault.com/api/v1/indicators/file/{hash}/general" \
  -H "X-OTX-API-KEY: $OTX_API_KEY"
```
Sections: `/general`, `/analysis`

### URL Indicator
```bash
curl -s "https://otx.alienvault.com/api/v1/indicators/url/{url}/general" \
  -H "X-OTX-API-KEY: $OTX_API_KEY"
```

### Search Pulses
```bash
curl -s "https://otx.alienvault.com/api/v1/search/pulses?q={query}" \
  -H "X-OTX-API-KEY: $OTX_API_KEY"
```

## Key Response Fields
- `pulse_info.count` — number of pulses referencing this indicator
- `pulse_info.pulses[]` — pulse details (name, description, tags, TLP, created)
- `reputation` — community reputation score
- `validation[]` — validation results from OTX
- `passive_dns[]` — historical DNS resolutions

## CTI Value
OTX provides community-sourced intelligence. High pulse count = widely reported indicator. Useful for:
- Corroboration with other sources
- Discovering related indicators via pulse associations
- Historical passive DNS data
- Community context (pulse descriptions explain what the indicator relates to)

## Response Summary Format
```yaml
indicator: <value>
type: <ip|domain|hash|url>
pulse_count: <number>
reputation: <score>
key_pulses:
  - name: <pulse name>
    tags: [<tags>]
    created: <date>
related_indicators: [<list>]
passive_dns: [<domain/IP resolutions>]
verdict: known-malicious|suspicious|clean|unknown
```
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall