ArcGrade API

Integrate on-chain reputation directly into your DApp. Gate access, reward users, or analyze wallet behavior with a simple API.

Getting Started

Endpoints

GET/api/v1/score/[address]

Retrieves the current trust score for any wallet address on Arc Testnet.

Response Example

{
  "address": "0x123...abc",
  "score": 87,
  "verdict": "Trusted",
  "lastUpdated": "2026-05-17T12:00:00.000Z",
  "breakdown": {
    "transactionCount": 20,
    "walletAge": 18,
    "consistency": 19,
    "reliability": 17,
    "activityScore": 13
  }
}

Code Snippets

JavaScript (Fetch)

fetch('https://arcgrade.app/api/v1/score/0x123...')
  .then(res => res.json())
  .then(console.log);

cURL

curl -X GET \
  https://arcgrade.app/api/v1/score/0x123...

Rate Limiting

The API is rate-limited to 100 requests per hour per IP address. Exceeding this limit will result in a 429 Too Many Requests response.

CORS Enabled

All endpoints support Cross-Origin Resource Sharing (CORS) from any domain (*), making it easy to integrate directly into your frontend DApps.