# CodePulse API – IP Abuse Score Lookup

> CodePulse API – IP Abuse Score Lookup is a paid API for AI agents from codepulse-api.hahavoid0.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns an abuse score and confidence level for a given IPv4 or IPv6 address to help assess whether it is associated with malicious activity.

## Facts

- Endpoint: POST https://codepulse-api.hahavoid0.workers.dev/security/ip-abuse
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/codepulse-api-ip-abuse-score-lookup-2a035957
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uGrKXbjA3kRsr8kSGWdC5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability codepulse-api-ip-abuse-score-lookup-2a035957 -d '<json body>'
```

Example prompt: Can you check if the IP address 203.0.113.42 has any known abuse history or a high abuse score?

## When to prefer this

Choose this endpoint when you need a quick, pay-per-call IP reputation check without committing to a recurring API subscription. It is well suited for low-volume, event-driven checks (e.g. login events, order placements, inbound traffic vetting) where you pay only for what you use via USDC on Base. Prefer alternatives with SLA guarantees or bulk pricing for high-throughput pipelines.

## Known failure modes

- Invalid IP format — returns error if the input is not a valid IPv4 or IPv6 address
- Unsupported IP — 'supported: false' returned for IPs not in the database
- Private/reserved IP ranges (e.g. 127.0.0.1) may return an abuseScore of 0 with a warning
- Payment failure — USDC payment not completed, request rejected
- Rate limiting or worker timeout on the Cloudflare edge

## How this service works

Queries IP reputation scoring to detect botnet, spamming, or hacking origin IPs.

## Output

A JSON object containing the queried IP address, a numeric abuse score (higher = more abusive), a confidence level (e.g. 'high'), whether the IP is supported by the lookup database, the data freshness date, any warnings, and a disclaimer. Example: {ip: '127.0.0.1', abuseScore: 0, confidence: 'high', supported: true, data_as_of: '2026-06'}.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "ip"
     ],
     "properties": {
      "ip": {
       "type": "string",
       "description": "IPv4 or IPv6 address"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "ip": "127.0.0.1",
   "abuseScore": 0
  },
  "warnings": [],
  "supported": true,
  "confidence": "high",
  "data_as_of": "2026-06",
  "disclaimer": "Informational support only. Not legal, tax, medical, veterinary, or financial advice. Verify with the cited official source or a qualified professional before acting."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/codepulse-api-ip-abuse-score-lookup-2a035957/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from codepulse-api.hahavoid0.workers.dev](https://www.zero.xyz/host/codepulse-api.hahavoid0.workers.dev/llms.txt)