API

API Docs

Programmatic TRON USDT screening for workspace API keys and x402 agent payments.

x402 agent payments

Three pay-per-request tiers for one public TRON address, with x402 v2 (challenge-first). No Clerk session, API key, or prepaid credits. Unpaid requests receive HTTP 402 before body validation; the paid retry validates the TRON address and settles only on success. Payment settles in USDC on Base. Results are informational — not an automated accept/reject decision.

  • POST /v1/x402/blacklist$0.01 USDC

    Live check of whether Tether has frozen (blacklisted) one public TRON address in the USDT TRC20 contract. Answers: can this address still move USDT right now?

  • POST /v1/x402/screen$0.10 USDC

    Screen one public TRON address for direct USDT freeze status (three sources), OFAC and OpenSanctions matches, Chainabuse reports, an explainable risk score, confidence, data coverage, and evidence. Looks at the address itself, not its counterparties.

  • POST /v1/x402/report$1.00 USDC

    Full AML report for one public TRON address: everything in the sanctions screen plus direct counterparty exposure, two-hop tracing, flow heuristics, an explainable 0-100 risk score with confidence, and coverage. The same deep analysis a signed-in user gets on usdt.chikocorp.com.

curl -i -X POST https://usdt.chikocorp.com/v1/x402/screen \
  -H "Content-Type: application/json" \
  -d '{"address":"T..."}'
# Expect HTTP 402 + PAYMENT-REQUIRED header for x402-compatible agents.
# After authorizing USDC on Base, retry with the PAYMENT-SIGNATURE header.

Discovery: /.well-known/x402.json · /llms.txt. Set X402_PUBLIC_ORIGIN on previews.

POST /v1/screen

Use a bearer API key with the screen:write scope. Include Idempotency-Key for retry-safe writes.

curl -X POST https://usdt.chikocorp.com/v1/screen \
  -H "Authorization: Bearer usk_live_..." \
  -H "Idempotency-Key: quote-123" \
  -H "Content-Type: application/json" \
  -d '{"address":"T..."}'

OpenAPI JSON: /openapi.json

Batch, reports, watchlist, webhooks

Use scoped bearer keys. Batch jobs accept up to 500 JSON address rows and return row-level validation.

POST /v1/batches
GET  /v1/batches/{id}
GET  /v1/reports/{id}
POST /v1/watchlist
POST /v1/webhooks/test

Webhook deliveries include x-tron-checker-signature, x-tron-checker-timestamp, and x-tron-checker-event headers.