Collar Guardrail

{
  "name": "Collar Guardrail",
  "description": "Deterministic pre-trade risk layer for autonomous AI trading agents on Robinhood Chain. Returns allow / warn / deny verdicts with the reasons attached and a tamper-evident audit hash.",
  "url": "https://api.collarguardrail.com",
  "version": "1.0.2",
  "protocolVersion": "0.3.0",
  "preferredTransport": "HTTP+JSON",
  "provider": {
    "organization": "Collar",
    "url": "https://collarguardrail.com"
  },
  "documentationUrl": "https://collarguardrail.com/agent-docs.html",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "securitySchemes": {
    "bearer": {
      "type": "http",
      "scheme": "bearer",
      "description": "JWT obtained via EIP-191 wallet signature at /api/v1/auth/wallet."
    },
    "x402": {
      "type": "http",
      "scheme": "x402",
      "description": "$0.01 USDG per call on Robinhood Chain (eip155:4663). No signup. Payment settles via the x402 protocol."
    }
  },
  "security": [
    {
      "bearer": []
    },
    {
      "x402": []
    }
  ],
  "skills": [
    {
      "id": "evaluate_trade",
      "name": "Evaluate a trade",
      "description": "Pre-trade risk check. Returns allow, warn, or deny, with every reason attached and a tamper-evident audit hash. Checks tier limits, oracle/V4 price source, slippage, market hours, cluster rate limits, and daily loss. If check_token_safety returned severity=danger for the contract, this skill automatically returns deny regardless of other checks.",
      "tags": [
        "risk",
        "guardrail",
        "trading",
        "compliance"
      ],
      "examples": [
        "Evaluate a 10 NVDA buy from wallet 0x... before signing.",
        "Check if a proposed ETH sell of 5 units crosses any limit."
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "endpoint": {
        "method": "POST",
        "path": "/api/v1/analyze/trade",
        "requires": "bearer"
      },
      "inputSchema": {
        "type": "object",
        "required": [
          "wallet",
          "asset",
          "side",
          "amount",
          "contract_address"
        ],
        "properties": {
          "wallet": {
            "type": "string",
            "pattern": "^0x[a-fA-F0-9]{40}$",
            "description": "Wallet address the trade would execute from."
          },
          "asset": {
            "type": "string",
            "maxLength": 32,
            "description": "Asset symbol, e.g. NVDA, AAPL, ETH, USDG."
          },
          "side": {
            "type": "string",
            "enum": [
              "buy",
              "sell"
            ]
          },
          "amount": {
            "type": "number",
            "exclusiveMinimum": 0,
            "description": "Quantity in token units, not USD."
          },
          "contract_address": {
            "type": "string",
            "pattern": "^0x[a-fA-F0-9]{40}$",
            "description": "Must match the official registry entry for the symbol."
          },
          "max_slippage_bps": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000,
            "default": 100
          },
          "request_id": {
            "type": "string",
            "description": "Idempotency key, cached 5 minutes."
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "decision": {
            "type": "string",
            "enum": [
              "allow",
              "warn",
              "deny"
            ]
          },
          "reasons": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "tier": {
            "type": "integer"
          },
          "max_trade_usd": {
            "type": "number"
          },
          "calculated_notional_usd": {
            "type": "number"
          },
          "price_usd": {
            "type": "number"
          },
          "price_source": {
            "type": "string",
            "enum": [
              "oracle",
              "uniswap_v4",
              "fallback_default",
              "unavailable"
            ]
          },
          "risk_score": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100
          },
          "timestamp": {
            "type": "integer"
          },
          "request_id": {
            "type": "string"
          },
          "audit_hash": {
            "type": "string"
          },
          "audit_seq": {
            "type": "integer"
          },
          "daily_pnl_usd": {
            "type": "number"
          },
          "error": {
            "type": "string",
            "description": "If present, no verdict was produced. Treat as a hard stop; do not execute the trade."
          }
        }
      }
    },
    {
      "id": "check_token_safety",
      "name": "Check token safety",
      "description": "Honeypot and contract safety check for any ERC-20 token. Returns severity (safe, warn, danger) and the specific risk factors found, using bytecode analysis and a live sell simulation. CRITICAL: when severity=danger, the next evaluate_trade call for the same contract is automatically denied. Use before trading unknown tokens or tokens absent from the official registry.",
      "tags": [
        "security",
        "honeypot",
        "token",
        "erc20"
      ],
      "examples": [
        "Is contract 0x... a honeypot?",
        "Check this token before I let the agent buy it."
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "endpoint": {
        "method": "POST",
        "path": "/api/v1/token-safety",
        "requires": "none"
      },
      "inputSchema": {
        "type": "object",
        "required": [
          "contract_address"
        ],
        "properties": {
          "contract_address": {
            "type": "string",
            "pattern": "^0x[a-fA-F0-9]{40}$"
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "severity": {
            "type": "string",
            "enum": [
              "safe",
              "warn",
              "danger"
            ]
          },
          "is_honeypot": {
            "type": "boolean"
          },
          "risk_factors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "owner_renounced": {
            "type": "boolean"
          },
          "owner_is_multisig": {
            "type": "boolean"
          },
          "sell_simulation": {
            "type": "object"
          }
        }
      }
    },
    {
      "id": "simulate_balance",
      "name": "Simulate a wallet balance",
      "description": "Read-only state-override simulation of an ERC-20 balance after a hypothetical trade. No transaction is sent.",
      "tags": [
        "simulation",
        "balance",
        "erc20"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "endpoint": {
        "method": "POST",
        "path": "/api/v1/simulate-balance",
        "requires": "none"
      },
      "inputSchema": {
        "type": "object",
        "required": [
          "token_address",
          "holder",
          "delta"
        ],
        "properties": {
          "token_address": {
            "type": "string",
            "pattern": "^0x[a-fA-F0-9]{40}$"
          },
          "holder": {
            "type": "string",
            "pattern": "^0x[a-fA-F0-9]{40}$"
          },
          "delta": {
            "type": "number",
            "description": "Signed amount. Negative = spend."
          },
          "balance_slot": {
            "type": "integer",
            "minimum": 0,
            "maximum": 64
          },
          "decimals": {
            "type": "integer",
            "minimum": 0,
            "maximum": 36,
            "default": 18
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "token_address": {
            "type": "string"
          },
          "holder": {
            "type": "string"
          },
          "balance_slot": {
            "type": "integer"
          },
          "current": {
            "type": "number"
          },
          "delta": {
            "type": "number"
          },
          "post_trade": {
            "type": "number"
          }
        }
      }
    },
    {
      "id": "get_supported_assets",
      "name": "List supported assets",
      "description": "The official Robinhood Chain asset registry with canonical contract addresses. Resolve a symbol correctly before calling evaluate_trade.",
      "tags": [
        "registry",
        "assets",
        "robinhood-chain"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "endpoint": {
        "method": "GET",
        "path": "/api/v1/assets",
        "requires": "none"
      },
      "inputSchema": {
        "type": "object",
        "properties": {}
      },
      "outputSchema": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "symbol": {
              "type": "string"
            },
            "contract_address": {
              "type": "string"
            },
            "is_native": {
              "type": "boolean"
            }
          }
        }
      }
    },
    {
      "id": "verify_audit_trail",
      "name": "Verify audit trail",
      "description": "Recompute every past decision's SHA-256 hash and verify the hash-chain links. Proves no decision was edited, deleted, or reordered.",
      "tags": [
        "audit",
        "verification",
        "compliance"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "endpoint": {
        "method": "GET",
        "path": "/api/v1/audit/verify/{wallet}",
        "requires": "none"
      },
      "inputSchema": {
        "type": "object",
        "required": [
          "wallet"
        ],
        "properties": {
          "wallet": {
            "type": "string",
            "pattern": "^0x[a-fA-F0-9]{40}$"
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1000,
            "default": 100
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "wallet": {
            "type": "string"
          },
          "total": {
            "type": "integer"
          },
          "tampered": {
            "type": "integer"
          },
          "healthy": {
            "type": "boolean"
          },
          "records": {
            "type": "array",
            "items": {
              "type": "object"
            }
          }
        }
      }
    }
  ]
}