⬡ AlgoSentry

Algorand ASA fraud detection · Pay-per-call via x402 · ok warning high_risk

Endpoints

Method Path Description Price
GET /v1/asa/registry-check Check if an ASA is a known scam or clone. Returns verdict, score 0-100, flags, holder distribution. 0.02 USDC or 0.05 ALGO
GET /v1/network/pulse Live Algorand network snapshot: current round, estimated TPS, average block time, minimum fee. 0.01 USDC or 0.025 ALGO
POST /v1/contract/audit Audit a TEAL or Puya smart contract for security issues (rekey abuse, missing auth checks, unchecked group assumptions...). Powered by Claude. ~0.20-2.00 USDC (varies with code size & AI cost)
GET /v1/ping-sample Free sample response for USDC (ASA 31566704). Use to validate integration before first paid call. FREE
GET /healthz Service liveness check. FREE

How to call (x402 flow)

  1. GET /v1/asa/registry-check?asset_id=31566704 — no header → 402 with payment instructions (payTo, price, accepted assets)
  2. Send on-chain payment — 20000 microUSDC (ASA 31566704) or 50000 microALGO to the payTo address. Algorand confirms in ~3s.
  3. Retry with header — X-PAYMENT: <base64_payment_proof>
  4. Receive 200 — JSON response with verdict, score, flags, evidence, payment_receipt.

Add Idempotency-Key: <uuid> to safely retry on timeout — no double charge. If we fail after payment, the error response contains a credit nonce to replay free.

Machine discovery

/openapi.json Full OpenAPI 3.1 schema /.well-known/llms.txt LLM-optimized service description /.well-known/x402.json x402 pricing manifest /v1/ping-sample Free sample response /docs Swagger UI

Payment proof format (X-PAYMENT header)

Base64-encode this JSON and send as X-PAYMENT header:

{
  "x402Version": 1,
  "scheme": "exact",
  "network": "algorand-mainnet",
  "payload": {
    "txid": "<ALGORAND_TRANSACTION_ID>",
    "asset": "31566704"
  }
}