Quick Start

Get live DappScore data into your app in under 5 minutes. No API key required for read-only data.


1. Fetch a Trust Score (No Auth)

Look up any project by its contract address:

curl https://us-central1-<project>.cloudfunctions.net/api/v1/projects/0xYourContractAddress

Response:

{
  "data": {
    "id": "0xYourContractAddress",
    "name": "My Project",
    "trustScore": 84,
    "trustLevel": 4,
    "votes": 1240,
    "scamFlag": false,
    "chain": "ethereum",
    "category": "defi"
  }
}

2. Scan a Contract for Risks (No Auth)

Response:

Risk Level
Score Range
Meaning

low

0–25

No significant concerns

medium

26–50

Some caution advised

high

51–75

Multiple risk factors present

critical

76–100

Serious red flags β€” avoid



4. Track Whale Activity (No Auth)


5. Publish Sale Progress (API Key Required)

If you're a project running a token sale, push live fundraising data to your DappScore listing:

The live progress will immediately appear on your project's listing page. Call this endpoint whenever your figures update β€” it's idempotent.

circle-info

Need a key? See Authentication to create one with sale:write permission.


6. Receive Real-Time Alerts via Webhook

Register a webhook to get notified the moment a project is flagged as a scam, a trust level changes, or a whale moves funds:

DappScore will POST a signed JSON payload to your URL whenever one of those events fires. Verify the signature using the X-DappScore-Signature header (HMAC-SHA256 of the raw body with your webhook secret).

Event
When it fires

project.trust_changed

A project's trust level goes up or down

project.scam_flagged

Community or automated scam flag is raised

project.created

A new project is listed

vote.cast

A vote is submitted on any project

whale.activity

A large token transfer is detected

market.resolved

A prediction market closes

bounty.completed

A bounty is awarded


JavaScript SDK Snippet


Next Steps

Every endpoint, parameter, and response shape

Create and manage API keys

❓ FAQ

Common questions

πŸ’¬ Contact

Get help

Last updated