# RelayShield

> Threat intelligence and identity-compromise APIs for developers and AI agents.
> Breach exposure, infostealer logs, SIM-swap, domain lookalikes, LLM credential
> exposure and MCP registry risk, over REST, MCP, STIX/TAXII 2.1, MISP and x402.

Authentication: send your key as the `X-RS-API-KEY` header. Pay-as-you-go with no
monthly minimum; `/v1/payg/*` endpoints accept x402 USDC payment with no API key.
Get a key at https://api.relayshield.net/developers

## Machine-readable

- [API reference](https://api.relayshield.net/docs): every endpoint with its parameters, response attributes, errors and examples
- [OpenAPI specification](https://api.relayshield.net/openapi.json): the same reference as OpenAPI 3.1 JSON, with per-call prices
- [Service discovery](https://api.relayshield.net/): endpoint inventory as JSON

## Threat intelligence feeds

- [STIX/TAXII 2.1](https://api.relayshield.net/v1/intel/taxii/): TAXII 2.1 server, collection id `iocs`. Requires a TI subscription.
- [MISP REST](https://api.relayshield.net/v1/intel/misp/): MISP-compatible `attributes/restSearch`. Requires a TI subscription.

## Integration guides

- [Ingest RelayShield threat intelligence into Microsoft Sentinel](https://api.relayshield.net/guides/microsoft-sentinel)
- [Ingest RelayShield threat intelligence into Elastic Security](https://api.relayshield.net/guides/elastic-security)

## Threat research

- [Blog archive](https://blog.relayshield.net): threat research and integration write-ups
- [RSS feed](https://blog.relayshield.net/rss.xml)
- [Blog sitemap](https://blog.relayshield.net/sitemap.xml)

## Endpoints

- `POST /v1/metered/breach` ($0.10/call): Check whether an email address appears in known data breaches. Returns breach count, source names, dates, and exposed data types (passwords, emails, etc). Call before trusting a new user identity or granting elevated access.
- `POST /v1/metered/bulk-identity-risk` ($2.00/call): Score up to 10 organizational domains, each with up to 5 associated agent/employee emails, for combined breach/infostealer/session/CVE risk in one call. Built for enterprise AI-governance platforms scoring many identities per customer in one pass, the recommended entry point for agent-governance and identity-posture integrations.
- `POST /v1/metered/cert-expiry` ($0.05/call): Check how many days remain before a domain's TLS certificate expires, via Certificate Transparency logs. Call to catch a lapsing certificate before it causes an outage, especially relevant as CA/Browser Forum rules shrink standard certificate lifespans toward 47 days by 2029.
- `POST /v1/metered/domain` ($0.50/call): Scan a domain for phishing lookalikes: typosquats, homoglyphs, and common phishing registration patterns. Returns matched lookalike domains found in the wild. Call to detect brand-impersonation phishing campaigns targeting a company before they're reported elsewhere.
- `POST /v1/metered/identity-graph` ($0.35/call): Correlate an email address against the criminal breach/stealer corpus to surface linked phone numbers, secondary domains, and other identifiers tied to the same compromised identity. Call to map the blast radius of a known compromise across an organization.
- `POST /v1/metered/identity-risk-score` ($0.35/call): Return a 0-100 domain security score across 6 identity-risk dimensions (breach exposure, infostealer density, ransomware exposure, session exposure, CVE exposure, threat-actor targeting) with a letter grade and plain-English risk factors. Call as a single-number identity health check before onboarding, financing, or partnering with a domain.
- `POST /v1/metered/infostealer` ($0.15/call): Check whether an email address's credentials were harvested by infostealer malware and appear in a criminal stealer-log marketplace, detected 24-72 hours ahead of public breach databases. Call to catch device-level compromise before stolen session cookies or saved passwords are used for account takeover.
- `POST /v1/metered/ip-intel` ($0.10/call): Look up passive DNS resolution history and reputation for a domain or IP address. For a domain: which IPs it has resolved to over time. For an IP: which hostnames have resolved to it, plus malicious/suspicious vendor detection counts. Call to pivot from an indicator to its infrastructure history during an investigation.
- `POST /v1/metered/llm-credential-exposure` ($0.40/call): Check whether a domain's LLM/AI provider API keys (OpenAI, Anthropic, Google, Groq, xAI, Replicate) appear exposed in criminal stealer logs. This is LLMjacking, a fast-growing threat where a leaked key becomes a live, uncapped billing liability rather than just a data exposure. Call to catch an exposed key before the drain, not after the invoice.
- `POST /v1/metered/nft-security` ($0.10/call): Screen an NFT contract for known scam, wash-trading, or malicious-approval risk signals before your agent buys, bids on, or approves it. Returns risk level and risk flags plus basic collection metadata. Call before an autonomous agent interacts with an unfamiliar NFT contract.
- `POST /v1/metered/nhi-exposure` ($0.40/call): Check whether API keys or tokens tied to a domain, used by non-human identities like AI agents, service accounts, or CI/CD, appear exposed in criminal stealer logs. Call to audit whether the credentials an autonomous agent relies on have already been compromised upstream.
- `POST /v1/metered/oauth-watchlist` ($0.30/call): Check whether an email address has OAuth-connected app credentials exposed in a known SaaS breach (GitHub, Slack, Notion, Zapier, and 30+ other high-risk OAuth-capable apps). Returns matched apps and direct revoke-access links. Call to detect supply-chain credential exposure via connected apps.
- `POST /v1/metered/ransomware-risk` ($0.40/call): Check whether a domain appears on a known ransomware group's victim/leak-site list, and whether pre-ransomware credential harvesting was detected beforehand. Call to assess active ransomware exposure for a domain, not just historical breach history.
- `POST /v1/metered/scan-file` ($0.10/call): Scan a file (via its public download URL) for malware using VirusTotal's multi-engine analysis. Returns an async analysis ID to poll. Call before an agent downloads, opens, or executes a file attachment from an untrusted source.
- `POST /v1/metered/scan-url` ($0.05/call): Scan a URL for phishing or malware using heuristic signals (Google Safe Browsing, RDAP domain age, known IOC corpus) plus VirusTotal multi-engine analysis. Returns an async analysis ID to poll. Call before an agent clicks, fetches, or shares a link from an untrusted source.
- `POST /v1/metered/scan-wallet` ($0.10/call): Screen an EVM wallet address for known scam, exploit, or sanctions-list association before your agent transacts with it. Returns a risk level and specific risk flags. Call before an autonomous agent sends funds to or interacts with an unfamiliar wallet.
- `POST /v1/metered/secret-scan` ($0.35/call): Scan public GitHub repositories, npm and PyPI packages, Docker Hub images, Hugging Face models and Spaces, and Postman public workspaces and collections for API keys, tokens and credentials already published against a domain. Repo-only scanners miss credentials shipped inside released packages and images. Every hit is verified against the credential pattern before it is reported.
- `POST /v1/metered/session-risk` ($0.30/call): Check whether an email address has an active stolen session cookie circulating in a criminal archive, a signal of account takeover that bypasses password resets and 2FA entirely. Call to detect AiTM/session-hijack attacks before an authenticated agent session is trusted.
- `POST /v1/metered/sim-swap` ($0.25/call): Check whether a phone number has had a SIM swap or carrier port in the last 24 hours via real-time carrier lookup. A recent swap is a strong signal of an active account-takeover attempt targeting SMS-based 2FA. Call before trusting an SMS OTP from this number.
- `POST /v1/metered/supply-chain` ($0.10/call): Check up to 10 vendor domains for combined breach, infostealer, and dark-web risk exposure in one call. Returns a composite risk score per vendor. Call to assess third-party API/vendor risk before an agent integrates with or continues calling an external service.
- `POST /v1/metered/target-risk` ($0.50/call): Score a domain's probability of being an active or upcoming cyberattack target using a 6-signal correlation model (breach, infostealer, ransomware, session, CVE, and threat-actor targeting history). Call for proactive risk triage, not just after-the-fact breach checking.
- `POST /v1/metered/tech-stack-cve` ($0.20/call): Check a declared technology stack (e.g. nginx, WordPress, Cisco IOS) against actively-exploited CVEs (CISA KEV) and high-EPSS-score vulnerabilities. Call before deploying or continuing to run a given technology stack in production.
- `POST /v1/metered/token-security` ($0.05/call): Screen an ERC-20/BEP-20 token contract for honeypot, mintable-supply, hidden-owner, and other rug-pull risk signals before your agent trades it. Returns risk level, specific critical/warning flags, and basic token metadata. Call before an autonomous trading agent buys or approves spending on an unfamiliar token.
- `POST /v1/metered/wallet-risk` ($0.05/call): Screen a wallet address across EVM, Solana, TON, or Bitcoin for known scam, exploit, drainer, or sanctions-list association before your agent transacts with it. Returns a risk level and specific risk flags. The recommended first call for any autonomous trading or DeFi agent before interacting with a new counterparty wallet.
- `POST /v1/metered/wallet-screen-batch` ($0.50/call): Screen up to 10 wallet addresses (any chain: EVM, Solana, TON, Bitcoin) for known scam or exploit association in a single call. Returns per-address risk level and flags. Use for bulk counterparty screening in trading or portfolio-monitoring agent workflows.