Structure grade

How to get it

token_overview · grade

Cost

2 credits a pull

Window

Up to 60 days

Get it

token_overview returns it at grade.

curl -X POST "https://api.blocktronics.xyz/v1/tools/token_overview" \
  -H "Authorization: Bearer $BLOCKTRONICS_KEY" \
  -H "content-type: application/json" \
  -d '{"token":"base:0x4ed4e862860bed51a9570b96d89af5e1b0efefed"}'

Understand this metric

A letter for how safely a position can be held and exited, built from six pillars: liquidity depth, ownership concentration, holder base, capital flow, holder economics and launch integrity.

• gates lists the structural dangers that capped the letter, in order. A gate only ever lowers a grade.
• C is the ordinary token, not a warning; 50 is typical for the fleet on every pillar.
• letter is null when coverage_state is INSUFFICIENT: withheld, not a low grade. PROVISIONAL grades are capped at B.
• Each pillar's detail is the one-line reading behind its score, or why it couldn't be measured. An unmeasured pillar has a null score: dropped, never scored zero.
• grade is null, with the reason in unavailable.grade, when no badge is stored yet. Draw a placeholder, never a guessed letter.

In the answer

{
  "letter": "B",
  "composite": 71.6,
  "pillars_present": 6,
  "pillars": [
    {
      "key": "depth",
      "label": "Depth",
      "score": 80,
      "detail": "4.8 bps · 1.62x the depth typical at this size"
    },
    {
      "key": "concentration",
      "label": "Concentration",
      "score": 84,
      "detail": null
    },
    "…"
  ],
  "computed_at": "2026-09-27T03:10:00.000Z",
  "coverage_state": "GRADED",
  "gates": [],
  "scoring_version": "grade-v5:depth-v1",
  "depth": {
    "d1_usd": 1850,
    "bps_of_cap": 4.78,
    "score": 80
  }
}

Availability and billing

A day with no figure is null, never 0, and unavailable names a panel that couldn't be read, with the reason. Keep gaps as gaps. See data availability and credits and billing.

More parts