# IPPulse — Full API Documentation

> IP intelligence — abuse reports, geo, ASN, hosting provider, threat classification
> Price: $0.005/query | Protocol: x402 | Networks: Solana + Base

## Endpoints

### /v1/lookup/{ip}
- Method: GET
- Price: $0.005 (5000 atomic USDC)
- Auth: PAYMENT-SIGNATURE header (x402) or Authorization: Bearer key

### /health
- Method: GET
- Price: No auth required
- Returns: { service: "IPPulse", status: "ok" }

### /llms.txt
- Method: GET
- Price: No auth required
- Returns: Machine-readable service index

## Authentication

### x402 (Recommended for agents)
1. Make request without payment
2. Parse 402 response PAYMENT-REQUIRED header (base64 JSON)
3. Sign payment authorization (EIP-3009 on Base, SPL transfer on Solana)
4. Retry with PAYMENT-SIGNATURE header

### API Key
Header: Authorization: Bearer ip_live_YOUR_KEY
Buy at: POST https://ippulse.waltsoft.net/checkout {"tier":"starter|pro|enterprise"}

## Payment Details
- Asset: USDC (6 decimals)
- Amount: 5000 atomic = $0.005
- Solana payTo: GsKr5q9TmiJQcEgUpBp2X6SmvSg3dnXuw2uxYJxgPTk8
- Base payTo: 0x318A4B4764eb37c3FCBcE434713128143815FD57
- Solana feePayer: resolved dynamically from GET /platform/v2/x402/supported (CDP fee-payer pool rotates; do not hardcode)

## Provider
Waltsoft · https://waltsoft.net · 12 pay-per-query intelligence APIs