Back to Collar Guardrail
Card snapshot
api.collarguardrail.com
·
2026-09-19 06:03:10 UTC
·
6ada6779578b5ff7c127706f7f674c308e2fed15f429b650b6158a210173d9bc
This is a frozen copy of the agent's agent-card.json as we observed it at the timestamp above. We capture a new snapshot every time the card's content hash changes. Useful for: forensic drift analysis, verifying downstream callers see the right version, reproducing routing decisions made historically.
{
"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"
}
}
}
}
}
]
}