DocsAPI Reference

API Reference

All endpoints follow a standard response envelope with data, error, and optional meta fields. Base URL: https://enigma.app

Standard Response Format

{
  "data":  { … } | null,
  "error": null   | { "message": "…", "code": "…", "fields": { … } },
  "meta":  { "page": 1, "limit": 20, "total": 1693, "totalPages": 85 }
}

Agents

List, search, and retrieve agent profiles from the on-chain registry.

GET/api/v1/agents

List all agents with optional filters, sorting, and pagination.

Parameters

Name	Type	Required	Description
type	string	No	Filter by agent type (e.g. MCP, A2A, WEB)
status	string	No	Filter by status: VERIFIED \| PENDING \| FLAGGED \| SUSPENDED
minTrustScore	number	No	Minimum trust score (0–100)
search	string	No	Full-text search on name and description
sortBy	string	No	Sort field: trust_score \| created_at \| updated_at
sortOrder	string	No	asc \| desc (default: desc)
page	number	No	Page number (default: 1)
limit	number	No	Items per page (default: 20, max: 100)

Response

{
  "data": [
    {
      "address": "0x1a2b3c…",
      "name": "AlphaBot",
      "type": "MCP",
      "status": "VERIFIED",
      "trust_score": 87,
      "services": ["mcp"],
      "created_at": "2025-01-10T12:00:00Z",
      "updated_at": "2025-06-01T08:30:00Z"
    }
  ],
  "error": null,
  "meta": { "page": 1, "limit": 20, "total": 1693, "totalPages": 85 }
}

GET/api/v1/agents/:address

Get full details for a single agent including services, capabilities, and registrations.

Response

{
  "data": {
    "address": "0x1a2b3c…",
    "name": "AlphaBot",
    "type": "MCP",
    "status": "VERIFIED",
    "trust_score": 87,
    "description": "Autonomous MCP agent for DeFi analytics",
    "owner_address": "0xabc…",
    "services": ["mcp"],
    "capabilities": ["swap", "bridge"],
    "registrations": ["avalanche-c-chain"],
    "created_at": "2025-01-10T12:00:00Z",
    "updated_at": "2025-06-01T08:30:00Z"
  },
  "error": null
}

GET/api/v1/agents/stats

Aggregated platform statistics: total agents, verified count, active in last 24 h, breakdown by type and status.

Response

{
  "data": {
    "total": 1693,
    "verified": 412,
    "active24h": 38,
    "byStatus": { "VERIFIED": 412, "PENDING": 1201, "FLAGGED": 47, "SUSPENDED": 33 },
    "byType":   { "MCP": 540, "A2A": 320, "WEB": 610, "CUSTOM": 223 }
  },
  "error": null
}

GET/api/v1/agents/sparklines

Batch fetch the last 10 trust score snapshots for up to 50 agents (for sparkline charts).

Parameters

Name	Type	Required	Description
addresses	string	Yes	Comma-separated list of agent addresses (max 50)

Response

{
  "data": {
    "0x1a2b3c…": [{ "v": 72 }, { "v": 75 }, { "v": 80 }, { "v": 87 }],
    "0x4d5e6f…": [{ "v": 55 }, { "v": 60 }]
  },
  "error": null
}

Trust Score

Retrieve the weighted trust score breakdown for any agent.

GET/api/v1/agents/:address/trust-score

Full trust score breakdown with individual component scores, weights, and details.

Response

{
  "data": {
    "address": "0x1a2b3c…",
    "score": 87,
    "breakdown": {
      "volume":  { "score": 90, "weight": 0.25, "weighted": 22.5, "details": { … } },
      "proxy":   { "score": 85, "weight": 0.20, "weighted": 17.0, "details": { … } },
      "uptime":  { "score": 92, "weight": 0.25, "weighted": 23.0, "details": { … } },
      "ozMatch": { "score": 78, "weight": 0.15, "weighted": 11.7, "details": { … } },
      "ratings": { "score": 82, "weight": 0.15, "weighted": 12.3, "details": { … } }
    },
    "lastUpdated": "2025-06-01T08:30:00Z"
  },
  "error": null
}

Ratings

Community ratings for agents. Submit and retrieve 1–5 star ratings.

GET/api/v1/agents/:address/ratings

Retrieve paginated community ratings for an agent.

Parameters

Name	Type	Required	Description
page	number	No	Page number (default: 1)
limit	number	No	Items per page (default: 10)

Response

{
  "data": [
    { "id": "…", "score": 5, "comment": "Great agent!", "rater_address": "0x…", "created_at": "…" }
  ],
  "error": null,
  "meta": { "page": 1, "limit": 10, "total": 42, "totalPages": 5 }
}

POST/api/v1/agents/:address/ratings🔒 Wallet signature required

Submit a community rating (1–5) for an agent. Requires a connected wallet.

Parameters

Name	Type	Required	Description
score	number	Yes	Rating from 1 to 5
comment	string	No	Optional text comment (max 500 chars)
wallet	string	Yes	Connected wallet address

Response

{
  "data": { "id": "…", "score": 5, "comment": "Great agent!", "created_at": "…" },
  "error": null
}

Reports

Submit reports for agents that violate platform policies.

POST/api/v1/agents/:address/reports🔒 Wallet signature required

Report an agent with a reason and optional description. Requires a connected wallet.

Parameters

Name	Type	Required	Description
reason	string	Yes	Report category: SPAM \| SCAM \| MALICIOUS \| OTHER
description	string	No	Additional details (max 1000 chars)
wallet	string	Yes	Connected wallet address

Response

{
  "data": { "id": "…", "reason": "SCAM", "created_at": "…" },
  "error": null
}

Registration

POST/api/v1/agents/register🔒 Wallet signature required

Parameters

Name	Type	Required	Description
address	string	Yes	Agent contract address on Avalanche C-Chain
name	string	Yes	Human-readable agent name (max 100 chars)
description	string	No	Agent description (max 500 chars)
type	string	Yes	Agent type: MCP \| A2A \| WEB \| CUSTOM
wallet	string	Yes	Owner wallet address

Response

{
  "data": {
    "address": "0x1a2b3c…",
    "name": "MyAgent",
    "status": "PENDING",
    "trust_score": 0
  },
  "error": null
}

System

Platform health and activity data.

GET/api/v1/health

Health check endpoint. Returns service status and database connectivity.

Response

{
  "data": {
    "status": "ok",
    "database": "connected",
    "timestamp": "2025-06-01T08:30:00Z"
  },
  "error": null
}

GET/api/v1/agents/activity

Agent registration and verification activity over time (used by the Activity Chart).

Parameters

Name	Type	Required	Description
days	number	No	Number of past days to return (default: 30)

Response

{
  "data": [
    { "date": "2025-05-31", "registrations": 12, "verifications": 4 },
    { "date": "2025-06-01", "registrations": 7,  "verifications": 2 }
  ],
  "error": null
}