---
name: binary-defense-artillery-banlist-ingestion
description: "How to get Binary Defense Artillery Banlist data into a pandas DataFrame and Parquet: access, the request, the format, limits, quirks and terms."
---

# Load the Artillery IP banlist into pandas and Parquet

Source entry: https://signal-lab-jet.vercel.app/datasets/binary-defense-artillery-banlist
Provider: https://www.binarydefense.com/banlist.txt
Checked against the provider's documentation: 2026-11-01

## Access
- No account or key. The plain-text banlist is a public HTTPS download for permitted non-commercial use.

## Request
```bash
curl 'https://www.binarydefense.com/banlist.txt'
```

## Format
Commented plain text followed by one IPv4 address per line, without per-address timestamps, categories, confidence or provenance.

## Load into pandas and Parquet
Needs Python 3 with requests, pandas and pyarrow.
```python
"""Binary Defense Artillery banlist -> pandas -> Parquet. No key."""
import io
import ipaddress
import requests
import pandas as pd

URL = "https://www.binarydefense.com/banlist.txt"
r = requests.get(URL, timeout=60)
r.raise_for_status()
values = []
for line in io.StringIO(r.text):
    value = line.strip()
    if value and not value.startswith("#"):
        values.append(str(ipaddress.ip_address(value)))
df = pd.DataFrame({"ip_address": values}).drop_duplicates()
df.to_parquet("binary_defense_artillery_banlist.parquet", index=False)
print(len(df), "unique IP addresses")
```
Run by us on 2026-11-01 (python 3.13.5 | pandas 3.1.0 | pyarrow 26.0.0 | requests 2.34.2). Result: 731 unique IP addresses

## Limits
- Rate limit: Not stated.
- No direct-file update schedule, historical archive or download cap is stated.
- Commercial service use and redistribution are prohibited by the accompanying terms.

## Quirks
- Skip comment and blank lines, validate each remaining value as an IP address and deduplicate before storage.
- The feed has no per-address age, reason, source or confidence fields; retain retrieval time outside the payload.
- Do not connect to, visit or fetch content from any listed address.

## Terms and attribution
- The feed is for public use but not commercial resale or a paid service.
- The site terms limit downloaded materials to personal, non-commercial use and prohibit sharing or redistribution.
- Terms page: https://binarydefense.com/terms-conditions

## Sources
- https://www.binarydefense.com/banlist.txt: "Note that this is for public use only."
- https://www.binarydefense.com/banlist.txt: "Use of these feeds for commerical (having others pay for a service) use is strictly prohibited."
- https://binarydefense.com/resources/blog/project-artillery-is-now-a-binary-defense-project/: "Artillery was a tool I created a number of years ago to create a way for early warning indicators and open source threat intelligence feeds."
- https://binarydefense.com/terms-conditions: "may only be used for your personal and non-commercial use"

## Help improve this skill
Missing a source, or see something to improve? Call the MCP tool suggest_source or feedback (or POST /api/suggest or /api/feedback). Reviewed ideas: https://signal-lab-jet.vercel.app/agent-suggestions

Information for educational purposes only. Free tiers, limits and licenses belong to the providers and may change; check the provider's own terms before using the data.
