Token Risk Score API

1{
2  "type": "object",
3  "additionalProperties": false,
4  "required": [
5    "tokenAddress"
6  ],
7  "properties": {
8    "tokenAddress": {
9      "type": "string",
10      "minLength": 32,
11      "description": "Token contract or mint address"
12    },
13    "chain": {
14      "type": "string",
15      "enum": [
16        "base",
17        "bsc",
18        "sol"
19      ],
20      "default": "base"
21    }
22  }
23}

1{
2  "type": "object",
3  "required": [
4    "riskScore",
5    "riskLevel",
6    "flags",
7    "warnings",
8    "summary"
9  ],
10  "properties": {
11    "address": {
12      "type": "string"
13    },
14    "chain": {
15      "type": "string"
16    },
17    "symbol": {
18      "type": [
19        "string",
20        "null"
21      ]
22    },
23    "riskScore": {
24      "type": "number"
25    },
26    "riskLevel": {
27      "type": "string",
28      "enum": [
29        "low",
30        "medium",
31        "high"
32      ]
33    },
34    "flags": {
35      "type": "array",
36      "items": {
37        "type": "string"
38      }
39    },
40    "warnings": {
41      "type": "array",
42      "items": {
43        "type": "string"
44      }
45    },
46    "summary": {
47      "type": "string"
48    },
49    "metrics": {
50      "type": "object",
51      "properties": {
52        "name": {
53          "type": [
54            "string",
55            "null"
56          ]
57        },
58        "liquidityUsd": {
59          "type": "number"
60        },
61        "holderCount": {
62          "type": "number"
63        },
64        "top10HolderRatePct": {
65          "type": "number"
66        },
67        "buyTaxPct": {
68          "type": "number"
69        },
70        "sellTaxPct": {
71          "type": "number"
72        },
73        "isHoneypot": {
74          "type": "boolean"
75        },
76        "isOpenSource": {
77          "type": "boolean"
78        },
79        "isRenounced": {
80          "type": "boolean"
81        },
82        "isLiquidityLocked": {
83          "type": "boolean"
84        },
85        "tokenAgeDays": {
86          "type": [
87            "number",
88            "null"
89          ]
90        },
91        "priceChange24hPct": {
92          "type": [
93            "number",
94            "null"
95          ]
96        }
97      }
98    }
99  }
100}

1{
2  "tokenAddress": "0x1bc0c42215582d5a085795f4badbac3ff36d1bcb",
3  "chain": "base"
4}

1{
2  "address": "0x1bc0c42215582d5a085795f4badbac3ff36d1bcb",
3  "chain": "base",
4  "symbol": "CLANKER",
5  "riskScore": 14,
6  "riskLevel": "low",
7  "flags": [],
8  "warnings": [
9    "Top 10 holders control 49.2% of supply.",
10    "Liquidity is not locked.",
11    "Audit note: This token has passed security checks with no risks detected."
12  ],
13  "summary": "$CLANKER shows no significant risk signals (14/100).",
14  "metrics": {
15    "name": "tokenbot",
16    "liquidityUsd": 775104,
17    "holderCount": 479543,
18    "top10HolderRatePct": 49.2,
19    "buyTaxPct": 0,
20    "sellTaxPct": 0,
21    "isHoneypot": false,
22    "isOpenSource": true,
23    "isRenounced": true,
24    "isLiquidityLocked": false,
25    "tokenAgeDays": 571,
26    "priceChange24hPct": -4.9
27  }
28}