{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/fiatdock-com/json-schema/fiatdock-com-address-intel-schema.json",
  "title": "AddressIntel",
  "description": "Paid. Address enrichment — EOA/contract/ERC-20 + nonce + balances + keyless GoPlus security verdict.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/fiatdock-com-chain-api-openapi.yml#/components/schemas/AddressIntel",
  "type": "object",
  "properties": {
    "network": {
      "type": "string",
      "description": "Chain read (always base)"
    },
    "address": {
      "type": "string",
      "description": "The queried address"
    },
    "type": {
      "type": "string",
      "description": "eoa | contract | erc20_contract"
    },
    "isContract": {
      "type": "boolean",
      "description": "true if the address has bytecode on Base"
    },
    "isErc20": {
      "type": "boolean",
      "description": "true if it is an ERC-20 token contract"
    },
    "token": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "name": {
          "type": [
            "string",
            "null"
          ]
        },
        "symbol": {
          "type": [
            "string",
            "null"
          ]
        },
        "decimals": {
          "type": "number"
        }
      },
      "required": [
        "name",
        "symbol",
        "decimals"
      ],
      "description": "ERC-20 identity when isErc20, else null"
    },
    "nonce": {
      "type": "number",
      "description": "Outgoing transaction count (account nonce)"
    },
    "ethBalance": {
      "type": "string",
      "description": "Native ETH balance as a decimal string"
    },
    "usdcBalance": {
      "type": "string",
      "description": "USDC balance as a decimal string"
    },
    "security": {
      "type": "object",
      "properties": {
        "verdict": {
          "type": "string",
          "description": "clean | flagged"
        },
        "isMalicious": {
          "type": "boolean",
          "description": "true if any GoPlus risk flag is set"
        },
        "flags": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "GoPlus risk flags that fired (e.g. phishing_activities, sanctioned, mixer)"
        },
        "source": {
          "type": "string",
          "description": "Security data source (GoPlus)"
        }
      },
      "required": [
        "verdict",
        "isMalicious",
        "flags",
        "source"
      ],
      "description": "Keyless GoPlus address-security verdict"
    },
    "summary": {
      "type": "string",
      "description": "One-line human-readable verdict"
    },
    "asOf": {
      "type": "string",
      "description": "ISO 8601 read time"
    }
  },
  "required": [
    "network",
    "address",
    "type",
    "isContract",
    "isErc20",
    "token",
    "nonce",
    "ethBalance",
    "usdcBalance",
    "security",
    "summary",
    "asOf"
  ]
}