dappgrade

dappgrade score — pre-transaction health/safety verdict for an onchain app, by contract address. Returns ok / caution / avoid / unknown with the coverage the verdict rests on.

Resource: dappgrade.vercel.app/v1/score

Network: eip155:8453 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0x4a0aed4ce878e44ef922941f2b06137bc0b69b69

Payment methods: — · Last validation: 2026-09-14 16:35:09.478+00

{
  "input": {
    "type": "object",
    "required": [
      "type",
      "method"
    ],
    "properties": {
      "type": {
        "type": "string",
        "const": "http"
      },
      "method": {
        "enum": [
          "GET"
        ],
        "type": "string"
      },
      "queryParams": {
        "type": "object",
        "required": [
          "chain",
          "address"
        ],
        "properties": {
          "chain": {
            "type": "string",
            "description": "EVM chain — id (8453), CAIP-2 (eip155:8453), or name (base, mainnet, arbitrum, optimism)"
          },
          "address": {
            "type": "string",
            "pattern": "^0x[a-fA-F0-9]{40}$",
            "description": "the contract address the agent is about to call"
          }
        }
      }
    },
    "additionalProperties": false
  },
  "output": {
    "type": "object",
    "required": [
      "type"
    ],
    "properties": {
      "type": {
        "type": "string"
      },
      "example": {
        "type": "object",
        "properties": {
          "tier": {
            "type": [
              "integer",
              "null"
            ]
          },
          "flags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "score": {
            "type": [
              "integer",
              "null"
            ]
          },
          "reasons": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "code": {
                  "type": "string"
                },
                "flag": {
                  "type": "string",
                  "description": "on CRITICAL_FLAG"
                },
                "check": {
                  "type": "string",
                  "description": "on CHECK_FAILED"
                },
                "detail": {
                  "type": "string"
                }
              }
            },
            "description": "stable machine-readable causes behind the verdict; see /v1/methodology → reason_codes"
          },
          "verdict": {
            "enum": [
              "ok",
              "caution",
              "avoid",
              "unknown"
            ],
            "type": "string",
            "description": "decision-shaped: ok = proceed, caution = hold, avoid = abort, unknown = not rated (never read as safe)"
          },
          "coverage": {
            "type": "number",
            "description": "0..1 fraction of the rubric that actually ran; meaningless to read score without it"
          },
          "freshness": {
            "type": [
              "object",
              "null"
            ],
            "description": "checked_at/age_seconds/stale. Pass max_age=<seconds> to get `unknown` + STALE_FOR_CALLER instead of an old answer — the observation still travels, so that response is billed normally. The scored fields are absent entirely (not null) on an `unknown` where we have no answer, and that one is free."
          },
          "verdict_reason": {
            "type": "string",
            "description": "prose; wording not stable — branch on reasons[].code"
          }
        }
      }
    }
  },
  "paymentRequirements": [
    {
      "raw": {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "version": "2"
        },
        "payTo": "0x4a0aed4ce878e44ef922941f2b06137bc0b69b69",
        "amount": "10000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 120
      },
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x4a0aed4ce878e44ef922941f2b06137bc0b69b69",
      "scheme": "exact",
      "network": "eip155:8453",
      "amountAtomic": "10000"
    }
  ]
}

Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.