Back to Docs

Documentation

Quickstart

All tiers

Sign up, create your first API key, and make your first rating call in under five minutes.

1. Sign up

Click Sign In in the top-right of the Verdict home page. Choose any of: email magic link, Google sign-in, or wallet connection. We use Privy for auth — your embedded wallet is created automatically if you sign in with email or Google.

Once signed in, you land on your dashboard. Free tier is immediate; no payment step needed for unauthenticated rating reads.

2. Create an API key

From the dashboard, click API Keys in the sidebar. Click Create new key, give it a label (e.g. production-server), and copy the plaintext key shown — this is the only time you'll see it. Store it as an environment variable on your server.

Security note

The full key is only shown once at creation time. The dashboard stores only a hashed prefix for display (vk_live_abcd...XXXX). If you lose a key, revoke it and create a new one — keys can't be recovered.

3. Your first call

Replace $VERDICT_KEY with your key (or set VERDICT_KEY in your env):

curl
curl -H "Authorization: Bearer $VERDICT_KEY" \
  https://api.verdict.finance/v1/protocols
Node.js
const response = await fetch("https://api.verdict.finance/v1/protocols", {
  headers: { Authorization: `Bearer ${process.env.VERDICT_KEY}` },
});
const { items } = await response.json();
console.log(`${items.length} rated protocols`);

You'll get back a list of rated protocols with composite scores and letter grades. The full scorecard (per-question scores, evidence) is gated to Pro+; see Subscription & Plans.

Next steps