Colyon Logo

Monchain Check

Monchain Check·HTTP API·V1

Getting started with the HTTP API

Authenticate, submit investigations, and subscribe to proactive enforcement signals

Getting started (HTTP API)

POST /v1/auth/token
Content-Type: application/json
{
  "client_id": "COLYON_ORG_ID",
  "client_secret": "<redacted>",
  "scopes": ["signals:write", "cases:read"]
}
  • Colyon issues short-lived access tokens (5 minutes) signed by lattice-bound HSMs.
  • Tokens scope which agents can launch what missions (signals, cases, policy updates).
  • Use the /v1/missions endpoint to submit wallet activity, protocol events, or threat intel.
POST /v1/missions
Authorization: Bearer <token>
Content-Type: application/json
{
  "mission_type": "transaction_intent",
  "network": "ethereum",
  "payload": {
    "from": "0xabc...",
    "to": "0xdef...",
    "value": "1.5",
    "asset": "ETH",
    "call_data": "0x..."
  },
  "policy_profile": "exchange-tier-1"
}

Mission responses stream back via webhook within 200ms (p95). The body includes consensus verdict, recommended action, and trace metadata for auditors.

Try it

Authenticated JSON call
{
"endpoint": "https://api.monchain.ai/v1/missions",
"token": "<YOUR_API_KEY>",
"payload": {
"mission_type": "transaction_intent",
"network": "ethereum"
}
}