A pay-per-call threat intelligence API for the Base blockchain, using USDC micropayments without API keys.

Stars

4

7-day growth

No data

Forks

0

Open issues

0

License

No data

Last updated

2026-07-29

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It combines M2M security data with a novel x402-compatible payment model, allowing instant, subscription-free access to on-chain risk analysis via simple USDC transfers.

Who it is for

  • Developers building smart contracts on Base
  • DeFi protocols needing automated contract vetting
  • Security researchers monitoring blockchain threats
  • Compliance teams seeking per‐call risk scores

Use cases

  • Scan a contract address before depositing funds
  • Set up a 7-day watchdog to detect verdict or risk changes
  • Pull daily threat feeds for batch analysis
  • Stream live threats in real time

Strengths

  • No API keys or sign-ups; pay with a single USDC transfer on Base
  • All responses include verdict score and risk flags, not just binary labels
  • Webhook support for watchdog eliminates polling
  • Public machine-readable catalogs (OpenAPI, x402, OpenAI tool schemas)

Considerations

  • Only supports the Base network (EIP-155:8453)
  • Each call requires a separate on-chain USDC payment, incurring gas costs
  • No free tier or batch discount
  • Limited to five predefined product endpoints

README quick start

BaseSentinel

M2M threat intelligence for Base (eip155:8453).
Pay per call with USDC — no API keys.

Live API: https://api.blackswanlabs.pl
Landing: https://blackswanlabs.pl


How payment works (2 steps)

  1. Send USDC on Base to the treasury wallet (exact product amount).
  2. Call the endpoint with header:
X-Payment-Proof: 0xYOUR_TX_HASH

The tx-hash is bound to the resource (e.g. contract address). Reuse on another address is rejected. Same hash cannot be replayed for a new paid call (KV anti-replay).

Treasury (Base)

0x21360A04853b85a8d2E918b73f97C8ccf5939946

Asset: native USDC on Base — 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913


Products & prices

ProductMethodPathPrice
Contract scanGET/scan/{address}0.005 USDC
Premium dossierGET/dossier/{address}0.25 USDC
Watchdog (7 days)POST/watch0.50 USDC
Daily threat feedGET/api/feed/daily/YYYY-MM-DD0.01 USDC
Live threat streamGET/stream/threats0.005 USDC / UTC day

Machine catalogs:

Errors: { "error_code": "...", "message": "...", "error": "..." } — branch on error_code.

Settlement: tx_hash_proof (USDC transfer + hash).


Example: scan a contract

1) Pay 0.005 USDC on Base to the treasury

Send exactly 0.005 USDC (or more) to:

0x21360A04853b85a8d2E918b73f97C8ccf5939946

Copy the transaction hash.

2) Call /scan with the proof

PowerShell:

curl.exe -s "https://api.blackswanlabs.pl/scan/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" `
  -H "X-Payment-Proof: 0xPASTE_YOUR_TX_HASH_HERE"

bash:

curl -s "https://api.blackswanlabs.pl/scan/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" \
  -H "X-Payment-Proof: 0xPASTE_YOUR_TX_HASH_HERE"

Without payment you get HTTP 402 with payment_info (amount, payTo, network).

Response includes status (SAFE / SUSPICIOUS / SCAM), agent verdict (CLEAR / CAUTION / AVOID), verdict_score, risk_flags, and enrichment dossier.


Example: premium dossier (0.25 USDC)

Description

Base threat intel API for agents: contract scans + CLEAR/CAUTION/AVOID verdicts, pay USDC via HTTP 402.

Related repositories

Similar projects matched by category, topics, and programming language.

deerwork-ai
Featured
deerwork-ai GitHub avatar

deer-workflow

An open-source Dynamic Workflow runtime that combines deterministic TypeScript orchestration with replaceable Agent runtimes.

AI & Machine LearningLarge Language Models
312
Jakubantalik
Featured
Jakubantalik GitHub avatar

thinking-orbs

A React component library that renders six hand-tuned animated thought orb loading indicators on a plain 2D canvas, with two purpose-tuned sizes and automatic theme detection for AI and agent UIs.

AI & Machine LearningAI Agents
1,191
makecindy
Featured
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI & Machine LearningLarge Language Models
958