DappScore API

Search and filter the full project index. Supports full-text search, category/chain filtering, trust level filtering, and sorting.

GET /api/v1/projects?query=uniswap&chain=ethereum&sortBy=trustScore&limit=10

{
  "data": [
    {
      "id": "0xabc...123",
      "name": "Uniswap V3",
      "chain": "ethereum",
      "category": "defi",
      "trustScore": 94,
      "trustLevel": 5,
      "votes": 12480,
      "status": "active"
    }
  ],
  "pagination": { "page": 1, "limit": 10, "total": 842, "pages": 85 }
}

Fetch full detail for a single project by contract address or project ID.

{
  "data": {
    "id": "0xabc...123",
    "name": "Uniswap V3",
    "description": "Decentralized exchange protocol",
    "chain": "ethereum",
    "category": "defi",
    "contractAddress": "0xabc...123",
    "trustScore": 94,
    "trustLevel": 5,
    "votes": 12480,
    "positiveVotes": 11800,
    "negativeVotes": 680,
    "verified": true,
    "scamFlag": false,
    "website": "https://uniswap.org",
    "twitter": "@Uniswap",
    "createdAt": "2024-01-15T10:30:00Z"
  }
}

Returns projects with the highest vote velocity in the given timeframe.

Returns projects similar to the given contract address based on category, chain, and trust profile.

Paginated list of all votes cast for this project.

Returns the full chronological history of trust level changes for a project. Useful for charting trust progression over time.

{
  "data": [
    {
      "timestamp": "2024-03-01T00:00:00Z",
      "trustLevel": 3,
      "trustScore": 61,
      "reason": "Community vote threshold reached"
    }
  ]
}

Returns current token sale/IDO data for a project if it exists.

{
  "raised": 450000,
  "goal": 1000000,
  "currency": "USDC",
  "tokenPrice": 0.05,
  "startDate": 1711929600,
  "endDate": 1714521600,
  "minContribution": 100,
  "maxContribution": 5000,
  "saleContract": "0xdef...456",
  "network": "ethereum",
  "updatedAt": 1710237600
}

Create or update token sale data for a project. Requires an API key with sale:write permission scoped to this project.

POST /api/v1/projects/0xabc...123/sale
Authorization: Bearer sk_live_...

{
  "raised": 250000,
  "goal": 1000000,
  "currency": "USDC",
  "tokenPrice": 0.05,
  "startDate": 1711929600,
  "endDate": 1714521600
}

{
  "ok": true,
  "data": {
    "raised": 250000,
    "goal": 1000000,
    "currency": "USDC",
    "tokenPrice": 0.05,
    "startDate": 1711929600,
    "endDate": 1714521600,
    "updatedAt": 1710237600
  }
}

Returns the full public profile for a wallet address.

{
  "data": {
    "address": "0xUser...abc",
    "reputation": 2840,
    "reputationLevel": "Gold",
    "totalVotes": 312,
    "accuracyRate": 0.847,
    "totalEarnings": "1420.50",
    "joinedAt": "2023-08-10T14:22:00Z"
  }
}

Paginated list of all votes cast by this user.

Returns detailed voting accuracy statistics — how often the user's votes aligned with the final trust outcome.

{
  "data": {
    "address": "0xUser...abc",
    "totalVotes": 312,
    "correctVotes": 264,
    "accuracyRate": 0.847,
    "scamsCaught": 18,
    "falsePositives": 4
  }
}

Returns the full earnings history for this user including $SCORE rewards, insurance payouts, and referral bonuses.

Returns a breakdown of the user's reputation score including earned from votes, bonuses, penalties, and current tier.

Returns the user's affiliate referral stats — number of referrals, total bonus earnings, and referred user list.

Returns the top users ranked by the given metric.

Returns overall platform statistics: total projects, votes, users, and scam reports.

{
  "data": {
    "totalProjects": 8420,
    "totalVotes": 2140000,
    "totalUsers": 94200,
    "scamsDetected": 1240,
    "totalInsurancePaid": "842000.00",
    "activeProjects": 6100
  }
}

Returns day-by-day activity data suitable for time-series charts.

Returns $SCORE token metrics including price, market cap, circulating supply, staking stats, and 24h change.

Returns current insurance pool balance, total claims paid, pending claims, and coverage statistics.

Returns prediction market stats: total markets, volume, open positions, and resolution accuracy.

Returns bounty program stats: open bounties, total rewards paid, and top earners.

Returns the full catalogue of known scam patterns used by the analysis engine. Useful for building UI explanations.

{
  "data": {
    "patterns": [
      {
        "id": "HONEYPOT_TRANSFER_RESTRICTION",
        "name": "Honeypot — Transfer Restriction",
        "severity": "critical",
        "description": "Contract prevents token sells via blacklist or transfer block"
      },
      {
        "id": "OWNERSHIP_NOT_RENOUNCED",
        "name": "Ownership Not Renounced",
        "severity": "medium",
        "description": "Owner retains admin powers (mint, pause, blacklist)"
      }
    ]
  }
}

Performs a full risk analysis on a contract address. Returns a numeric risk score, categorical risk level, and list of triggered pattern flags.

{
  "success": true,
  "data": {
    "address": "0xabc...123",
    "network": "mainnet",
    "riskScore": 78,
    "riskLevel": "high",
    "flags": [
      {
        "id": "HIGH_TAX",
        "name": "Excessive Tax",
        "severity": "high",
        "description": "Buy/sell tax exceeds 15%"
      }
    ],
    "analyzedAt": "2024-03-12T10:15:00Z"
  }
}

Risk Levels: low (0–25) · medium (26–50) · high (51–75) · critical (76–100) · unknown

Deep-dives into token holder distribution to identify whale concentration, team wallet sizes, and exchange ratios.

Analyze up to 10 contracts in a single request.

{
  "success": true,
  "data": {
    "analyzed": 3,
    "results": {
      "0xabc...1": { "riskScore": 12, "riskLevel": "low", "flags": [] },
      "0xabc...2": { "riskScore": 91, "riskLevel": "critical", "flags": [/* ... */] },
      "0xabc...3": { "riskScore": 44, "riskLevel": "medium", "flags": [/* ... */] }
    }
  }
}

Submit a community scam report for a contract. Reports are reviewed by the admin team and can trigger trust level changes.

Returns the top token holders (whales) for a given token.

{
  "success": true,
  "data": {
    "tokenAddress": "0xabc...123",
    "network": "mainnet",
    "whaleCount": 20,
    "whales": [
      {
        "address": "0xWhale...1",
        "balance": "4200000",
        "percentage": 4.2,
        "label": "Binance Hot Wallet",
        "type": "exchange"
      }
    ]
  }
}

Returns recent large transfers for a token within the given time window.

Returns aggregated whale activity analysis including buy/sell pressure, net flow, and trend classification.

{
  "data": {
    "tokenAddress": "0xabc...123",
    "network": "mainnet",
    "last24h": {
      "buyVolume": "1200000",
      "sellVolume": "800000",
      "netFlow": "400000",
      "transactions": 42
    },
    "trend": "accumulating",
    "analyzedAt": "2024-03-12T10:00:00Z"
  }
}

Returns large transfer events above a USD threshold for a given token.

Returns wallet info, ETH balance, and any human-readable label assigned to the address (exchange, team, fund, etc).

Add a token to the whale tracking list so that whale transfers trigger platform alerts.

Update the USD price for a tracked token to keep USD-threshold alerts accurate.

Assign a human-readable label to a wallet address for display purposes in whale lists.

Returns the authenticated user's alert feed, optionally filtered by type or read status.

{
  "success": true,
  "data": {
    "alerts": [
      {
        "id": "alert_abc123",
        "type": "scam_flagged",
        "title": "Project flagged as scam",
        "body": "ProjectX has been flagged by the community",
        "severity": "high",
        "read": false,
        "createdAt": "2024-03-12T09:00:00Z"
      }
    ],
    "total": 12,
    "hasMore": false
  }
}

Returns the number of unread alerts. Lightweight endpoint for badge indicators.

{ "success": true, "data": { "count": 5 } }

Returns the user's current alert delivery preferences. Defaults are applied if not previously set.

Update which alert types and delivery channels the user subscribes to.

Mark a specific alert as read.

Mark all of the user's alerts as read in one call.

{ "success": true, "data": { "count": 12 }, "message": "12 alerts marked as read" }

Permanently delete a single alert from the user's feed.

Returns all registered webhooks for the authenticated user.

Register a new webhook URL. The secret in the response is shown only once.

{
  "success": true,
  "data": {
    "id": "wh_abc123",
    "url": "https://yourapp.com/hooks/dappscore",
    "secret": "whsec_xxxxxxxxxxxx",
    "events": ["project.trust_changed", "project.scam_flagged"],
    "message": "Webhook registered. Save the secret — it will not be shown again."
  }
}

Update a webhook's URL, subscribed events, or active status.

Permanently delete a webhook and stop all future event deliveries.

Sends a test payload to the webhook URL and reports the HTTP status received.

{ "success": true, "data": { "statusCode": 200 }, "message": "Test delivery successful" }

Returns the last 50 delivery attempt logs for the webhook, including status codes, timestamps, and failure reasons.

Generates a new signing secret for the webhook. The old secret is immediately invalidated.

Create a new API key. The full key value is returned only in this response.

{
  "id": "key_abc123",
  "key": "sk_test_a1b2c3d4e5f6g7h8i9j0...",
  "keyPrefix": "sk_test_a1b2c3",
  "name": "My Sale Integration",
  "projectId": "0xabc...123",
  "permissions": ["sale:write"],
  "active": true,
  "usageCount": 0,
  "createdAt": "2024-03-12T10:00:00Z",
  "_warning": "Save this key now — it will not be shown again."
}

Lists all API keys for the user. Raw key values are never returned — only prefixes.

Returns metadata for a specific API key including usage count and last used timestamp.

Rename an API key. Only the label can be changed — permissions and project scoping are immutable.

Immediately and permanently revoke an API key. Any requests made with this key will return 401 after revocation.

Issues a new key value and immediately revokes the old one. The new raw key is returned only in this response.

Generates a shareable PNG card for a project showing its trust score, vote count, and category.

Generates a PNG stat card for a user showing reputation, accuracy rate, and total earnings.

Generates a PNG leaderboard snapshot card.

Generates a PNG card for a prediction market showing current odds, volume, and resolution status.

Receives Alchemy Activity webhook events for whale transaction detection. The payload signature is verified using the ALCHEMY_SIGNING_KEY environment variable.

Receives subgraph / Notifi webhook events (e.g. new votes, trust threshold crossings). Requests must include a valid SUBGRAPH_WEBHOOK_SECRET header.