blockINT API Reference

Two ways to authenticate

POST /c3-reports is always free — no auth or payment of any kind required.

All endpoints

All endpoints under https://blockint.ai/api/v1/

# With bint_ key
curl https://blockint.ai/api/v1/screen/0x1da5821544e25c636c1417ba96ade4cf6d2f9b5a   -H "x-api-key: bint_<key>"

# Keyless x402 — SDK handles payment automatically
const res = await fetch402("https://blockint.ai/api/v1/screen/0x1da5821544e25c636c1417ba96ade4cf6d2f9b5a");
const { riskScore, riskLevel, crimeTypes, reportCount } = await res.json();

curl -X POST https://blockint.ai/api/v1/check   -H "Content-Type: application/json"   -H "x-api-key: bint_<key>"   -d '{"addresses":["0xabc...","0xdef..."]}'

curl -X POST https://blockint.ai/api/v1/c3-reports   -H "Content-Type: application/json"   -d '{
    "crimeType": "phishing",
    "title": "Fake Uniswap airdrop",
    "description": "Site impersonates Uniswap, drains wallets on approval.",
    "scammerAddresses": ["0x1da5821544e25c636c1417ba96ade4cf6d2f9b5a"],
    "reportedDomains": ["uni-airdrop.xyz"],
    "amountLost": 4200
  }'

Integrating x402

blockINT uses the x402 open standard (HTTP 402 Pay-Per-Request). An x402-compatible SDK handles the full payment round-trip automatically.

Payment flow

SDKs

// npm install @x402/fetch viem
import { wrapFetch } from '@x402/fetch';
import { createWalletClient, http } from 'viem';
import { base } from 'viem/chains';
import { privateKeyToAccount } from 'viem/accounts';

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const wallet = createWalletClient({ account, chain: base, transport: http() });
const fetch = wrapFetch(wallet);

const res = await fetch('https://blockint.ai/api/v1/screen/0xADDRESS');
const { riskScore, riskLevel, crimeTypes } = await res.json();

// Parse settlement receipt (log for audit)
const paymentResponse = res.headers.get('payment-response');
if (paymentResponse) {
  const s = JSON.parse(Buffer.from(paymentResponse, 'base64').toString());
  console.log('Settled tx:', s.transaction, 'on', s.network);
}

# pip install x402 httpx eth-account
from x402.clients.httpx import X402HttpxClient
from x402.schemes.evm.exact import ExactEvmClientScheme
from eth_account import Account
import os

account = Account.from_key(os.environ['PAYER_PRIVATE_KEY'])
client = X402HttpxClient(account)
client.register_scheme(ExactEvmClientScheme())

response = client.get('https://blockint.ai/api/v1/screen/0xADDRESS')
data = response.json()

Payment networks

payment-response header

When a payment is charged, the server returns a payment-response header (Base64 JSON) containing transaction (on-chain tx hash), network (CAIP-2 chain ID), payer (EVM address), and success (boolean). Absence of the header means the request was served from the free tier.

Troubleshooting

Endpoint pricing

All prices in USDC. Payments settle on Base (eip155:8453) or Solana mainnet. Free tier: 10 calls/day with a bint_ API key.

Machine-readable discovery surfaces

All endpoints support automated discovery by agentic.market, Bazaar, and compliant agent runtimes.