{"skill":{"slug":"swaps-intel","displayName":"Swaps Intel","summary":"Assess cryptocurrency addresses for risk signals, labels, and reputation across blockchains using Swaps Intelligence API data.","description":"# Swaps Intel Skill\n\nYou are an agent with access to the Swaps Intelligence API.\nYour primary capability is to assess the risk and reputation of cryptocurrency addresses across multiple blockchains (EVM, UTXO, TRON, Solana, Bitcoin, XRP, TON and more).\n\n## Getting an API Key\nTo use this skill you need a Swaps Intel API key.\n\n**Request a key:** Email `api@swaps.app` with subject \"API Key Request\" and a short description of your use case.\nKeys are typically issued within 24 hours. Free tier is available (10 req/min, 500 req/day).\n\nOnce you have your key, set it as the `SWAPS_INTEL_API_KEY` environment variable, or pass it directly in the `x-api-key` header.\n\n## Versioning, Limits & Uptime\n- **Version**: 1.2.0\n- **Uptime**: Best-effort 99.9% SLA on API endpoints.\n- **Rate Limits**: Free 10 req/min / 500 req/day · Pro 60 req/min / 10,000 req/day\n\n## Core Capability\nWhen a user asks to check, verify, or assess a crypto address or transaction, use the base URL:\n`https://system.swaps.app/functions/v1/agent-api`\n\n## Actions Supported\n1. `agent.check` — Risk score + flags for a wallet address.\n2. `agent.trace` — Trace a transaction path across hops.\n3. `agent.tx` — Risk assessment for a specific transaction hash.\n\n## Authentication\nPass your API key in the `x-api-key` header (preferred) or as `Authorization: Bearer <key>`.\n\n## How to Use\n\n**Check an address:**\n```bash\ncurl -X POST https://system.swaps.app/functions/v1/agent-api \\\n  -H \"Content-Type: application/json\" \\\n  -H \"x-api-key: YOUR_API_KEY\" \\\n  -d '{\n    \"action\": \"agent.check\",\n    \"payload\": { \"address\": \"0x1234...\" }\n  }'\n```\n\n**Compatibility alias (also works):**\n```bash\ncurl -X POST https://system.swaps.app/functions/v1/agent-api/check_address_risk \\\n  -H \"Content-Type: application/json\" \\\n  -H \"x-api-key: YOUR_API_KEY\" \\\n  -d '{ \"address\": \"0x1234...\" }'\n```\n\n**Example response:**\n```json\n{\n  \"ok\": true,\n  \"requestId\": \"4e95d17b-...\",\n  \"data\": {\n    \"address\": \"0x...\",\n    \"chain\": \"1\",\n    \"riskScore\": 80,\n    \"riskLevel\": \"critical\",\n    \"flags\": [\n      { \"type\": \"blacklisted\", \"severity\": \"danger\", \"message\": \"Address flagged: blacklisted, stealing attack.\" }\n    ],\n    \"details\": { \"goplus\": { \"isBlacklisted\": true, \"maliciousReason\": \"blacklisted, stealing attack\" } }\n  }\n}\n```\n\n## Mandatory Risk Framing (required)\n- Treat output as **risk analytics signals**, not legal conclusions.\n- Use: **\"high risk signal\"**, **\"possible exposure\"**, **\"heuristic indicator\"**.\n- Avoid: \"confirmed criminal\", \"proven scammer\", \"guaranteed recovery\".\n\n## Required Disclaimer (always include in user-facing output)\n> Swaps Search provides blockchain analytics signals for informational purposes only. Results may include false positives or false negatives and are not legal, compliance, financial, or investigative advice. Swaps does not guarantee asset recovery outcomes. Users are solely responsible for decisions and actions taken based on these outputs.\n\n## Formatting Guidelines\n- State Risk Score and riskLevel first.\n- List all flags with their severity.\n- Include the full `requestId` for support references.\n- Do NOT alter factual fields or links returned by the API.\n\n## Error Handling\n| Code | Meaning |\n|------|---------|\n| 401 | Missing or invalid API key |\n| 403 | Key inactive or wrong scopes — contact api@swaps.app |\n| 429 | Rate limit exceeded — wait and retry |\n| 500 | Internal error — try again shortly |\n\nIf the API returns an error, state that the address could not be analyzed right now. Do not guess, infer, or hallucinate risk data.\n","tags":{"latest":"1.2.0","blockchain":"1.1.1","crypto":"1.1.1","fraud":"1.1.1","intelligence":"1.1.1","risk":"1.1.1","security":"1.1.1","web3":"1.1.1"},"stats":{"comments":0,"downloads":762,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":4},"createdAt":1772087707540,"updatedAt":1778491649051},"latestVersion":{"version":"1.2.0","createdAt":1772687323361,"changelog":"v1.2.0: Added API key acquisition flow (api@swaps.app), fixed required.credentials metadata to remove Suspicious flag, updated example response to match real API output, fixed smoke key scopes","license":null},"metadata":null,"owner":{"handle":"w3arecom","userId":"s17f45avw8pfj2fedjc4yh2a7n884shz","displayName":"supabank","image":"https://avatars.githubusercontent.com/u/213186112?v=4"},"moderation":null}