API Reference

REST API for querying trust scores, resources, and auditor data.

Base URL: https://api.isnad.md

Endpoints

GET/api/v1/stats

Get protocol-wide statistics

01{
02 "success": true,
03 "stats": {
04 "resources": 142,
05 "attestations": 1847,
06 "auditors": 38,
07 "totalStaked": "4250000000000000000000000"
08 }
09}
GET/api/v1/trust/:hash

Get trust score and attestations for a resource

01{
02 "success": true,
03 "resource": { "hash": "0x...", "type": "SKILL", ... },
04 "trustScore": "2500000000000000000000",
05 "trustTier": "VERIFIED",
06 "attestations": [
07 { "auditor": "0x...", "amount": "1000...", "lockUntil": ... }
08 ]
09}
GET/api/v1/resources

List inscribed resources

Query Parameters:

  • type — Filter by type (SKILL, CONFIG, etc.)
  • limit — Max results (default 20)
  • offset — Pagination offset
01{
02 "success": true,
03 "resources": [
04 { "hash": "0x...", "type": "SKILL", "name": "weather", ... }
05 ]
06}
GET/api/v1/auditors

Get auditor leaderboard

Query Parameters:

  • limit — Max results (default 10)
01{
02 "success": true,
03 "auditors": [
04 {
05 "address": "0x...",
06 "totalStaked": "45000000000000000000000",
07 "attestationCount": 127,
08 "accuracy": 99.2
09 }
10 ]
11}
GET/health

Health check endpoint

01{ "status": "ok", "timestamp": "2024-..." }

Error Responses

All errors return a consistent format:

01{
02 "success": false,
03 "error": "Resource not found"
04}

Rate Limits

  • 100 requests per minute per IP
  • Responses are cached for 30 seconds
  • For higher limits, contact us about API keys