Api Endpoint

On-chain Forensics

Summarize ERC-20 transfer activity in a token verdict card

Open interactive test console

Offering

Provider
On-chain Forensics
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Financial Analysis
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://solene-fa2010da.base44.app/functions/forensicsVerdict
MIME type
application/json
First seen
2026-10-31T14:59:46.576Z
Last seen
Tags
X402, blockchain, forensics, verdict, financial-analysis, tokens, Wallet, Base, Ethereum

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.02 USDC
Atomic price: 20000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "20000",
    "payTo": "0x8EBf296c6273760ed9604C428f7EC13255E46fb9"
  }
]

Observed health

Status
Reachable
Latest latency
452 ms
Average latency
1063 ms
HTTP status
400
Last checked
Reachability
100% over 2 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "http",
  "method": "GET",
  "queryParams": {
    "type": "object",
    "required": [
      "address"
    ],
    "properties": {
      "chain": {
        "enum": [
          "base",
          "ethereum"
        ],
        "type": "string",
        "default": "base",
        "description": "EVM chain to analyze; defaults to Base."
      },
      "address": {
        "type": "string",
        "pattern": "^0x[a-fA-F0-9]{40}$",
        "description": "ERC-20 contract address on the selected EVM chain."
      }
    }
  }
}

Output schema

{
  "type": "object",
  "required": [
    "service",
    "paid",
    "data"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "endpoint",
        "chain",
        "contract",
        "verdict_tier"
      ],
      "properties": {
        "chain": {
          "enum": [
            "base-mainnet",
            "ethereum-mainnet"
          ],
          "type": "string"
        },
        "flags": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "contract": {
          "type": "string"
        },
        "endpoint": {
          "type": "string",
          "const": "verdict"
        },
        "plain_take": {
          "type": "string"
        },
        "share_text": {
          "type": "string"
        },
        "token_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "window_min": {
          "type": "integer"
        },
        "burns_recent": {
          "type": [
            "integer",
            "null"
          ]
        },
        "mints_recent": {
          "type": [
            "integer",
            "null"
          ]
        },
        "token_symbol": {
          "type": [
            "string",
            "null"
          ]
        },
        "total_supply": {
          "type": [
            "string",
            "null"
          ]
        },
        "verdict_tier": {
          "type": "string",
          "description": "e.g. RED_HOT, ACTIVE, LIGHT_ACTIVITY, DORMANT, NOT_A_CONTRACT, UNKNOWN"
        },
        "activity_status": {
          "enum": [
            "OK",
            "PARTIAL_LOGS",
            "UNAVAILABLE_SILENT_EMPTY_LOGS"
          ],
          "type": "string"
        },
        "evaluated_blocks": {
          "type": "object",
          "properties": {
            "from_block": {
              "type": "integer"
            },
            "window_min": {
              "type": "integer"
            },
            "latest_block": {
              "type": "integer"
            }
          },
          "description": "The exact block range evaluated, so consumers can compare and reproduce results."
        },
        "largest_transfer": {
          "type": [
            "object",
            "null"
          ]
        },
        "transfers_recent": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Null when log reads were incomplete."
        },
        "logs_batches_failed": {
          "type": "integer"
        },
        "activity_score_0_100": {
          "type": "integer"
        },
        "unique_wallets_recent": {
          "type": [
            "integer",
            "null"
          ]
        },
        "concentration_top_wallet_share": {
          "type": "number"
        }
      },
      "description": "Deterministic token verdict card. Incomplete log reads return UNKNOWN tier with LOGS_UNAVAILABLE and null counts, never a false DORMANT."
    },
    "paid": {
      "type": "string",
      "description": "USDC amount reported by the provider; opt-in free trials are also supported."
    },
    "service": {
      "type": "string",
      "const": "onchain-forensics"
    },
    "free_trial": {
      "type": "object",
      "description": "Present for opt-in free-trial responses."
    },
    "settlement_tx": {
      "type": [
        "string",
        "null"
      ],
      "description": "Settlement transaction hash when available."
    }
  }
}