Api Endpoint

On-chain Forensics

Analyze ERC-20 supply changes and recent mint and burn activity

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/forensicsToken
MIME type
application/json
First seen
2026-10-31T14:59:46.576Z
Last seen
Tags
X402, blockchain, forensics, Token, financial-analysis, tokens, Wallet, Base, Ethereum

Payment pricing

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

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

Observed health

Status
Reachable
Latest latency
1279 ms
Average latency
2313 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",
    "properties": {
      "chain": {
        "enum": [
          "base",
          "ethereum"
        ],
        "type": "string",
        "default": "base",
        "description": "EVM chain for a raw address; named token aliases select their registered chain."
      },
      "token": {
        "enum": [
          "ondo",
          "qnt",
          "edel",
          "xlm",
          "aero",
          "degen",
          "brett",
          "buidl",
          "usdy",
          "ousg",
          "ustb",
          "usyc",
          "bcspx",
          "bcoin",
          "bnvda",
          "btsla",
          "aapl",
          "nvda",
          "usdc",
          "usdc_eth"
        ],
        "type": "string",
        "description": "Named EVM token alias; provide token or contract, not both."
      },
      "contract": {
        "type": "string",
        "pattern": "^0x[a-fA-F0-9]{40}$",
        "description": "ERC-20 contract address; provide contract or a named token alias, not both."
      }
    }
  }
}

Output schema

{
  "type": "object",
  "required": [
    "service",
    "paid",
    "data"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "endpoint",
        "chain",
        "contract"
      ],
      "properties": {
        "chain": {
          "enum": [
            "base-mainnet",
            "ethereum-mainnet"
          ],
          "type": "string"
        },
        "error": {
          "type": "string"
        },
        "contract": {
          "type": "string"
        },
        "decimals": {
          "type": [
            "integer",
            "null"
          ]
        },
        "endpoint": {
          "type": "string",
          "const": "token"
        },
        "burns_24h": {
          "type": "object",
          "properties": {
            "count": {
              "type": [
                "integer",
                "null"
              ]
            },
            "volume": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "mints_24h": {
          "type": "object",
          "properties": {
            "count": {
              "type": [
                "integer",
                "null"
              ]
            },
            "volume": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "token_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "burns_recent": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "count": {
              "type": [
                "integer",
                "null"
              ]
            },
            "status": {
              "enum": [
                "ok",
                "partial"
              ],
              "type": "string"
            },
            "volume": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "data_quality": {
          "enum": [
            "ok",
            "degraded_logs",
            "ok_partial_supply",
            "degraded_logs_partial_supply"
          ],
          "type": "string"
        },
        "mints_recent": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "count": {
              "type": [
                "integer",
                "null"
              ]
            },
            "status": {
              "enum": [
                "ok",
                "partial"
              ],
              "type": "string"
            },
            "volume": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "token_symbol": {
          "type": [
            "string",
            "null"
          ]
        },
        "activity_note": {
          "type": "string",
          "description": "Present when activity counts were withheld due to incomplete reads."
        },
        "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."
        },
        "total_supply_now": {
          "type": [
            "string",
            "null"
          ],
          "description": "Human-readable total supply at the token decimals; null when the supply read is unavailable."
        },
        "transfers_recent": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Null when log reads were incomplete."
        },
        "supply_read_status": {
          "enum": [
            "ok",
            "partial",
            "unavailable"
          ],
          "type": "string"
        },
        "logs_batches_failed": {
          "type": "integer"
        },
        "total_supply_24h_ago": {
          "type": [
            "string",
            "null"
          ]
        },
        "net_supply_change_24h": {
          "type": [
            "string",
            "null"
          ]
        },
        "unique_wallets_recent": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Null when log reads were incomplete."
        },
        "net_supply_change_pct_24h": {
          "type": [
            "string",
            "null"
          ]
        },
        "recent_activity_window_min": {
          "type": "integer"
        }
      },
      "description": "Token burn/mint forensics response (token route). Incomplete log reads withhold activity counts (null) instead of asserting zero inactivity; supply-read failures are surfaced via supply_read_status and data_quality."
    },
    "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."
    }
  }
}