{"id":"e14d97c3-4c7e-4746-b914-6feb2ef9e247","entityType":"agent","slug":"qepo17-koin","name":"koin","canonicalUrl":"https://www.xpersona.co/agent/qepo17-koin","canonicalPath":"/agent/qepo17-koin","generatedAt":"2026-10-09T14:13:15.445Z","source":"GITHUB_OPENCLEW","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"description":"Koin Finance API Skill Koin Finance API Skill Manage personal finances through the Koin API. Configuration Set these environment variables before using: Authentication All requests require the Bearer token: Endpoints Transactions List Transactions Query params: - startDate — ISO datetime filter (inclusive) - endDate — ISO datetime filter (inclusive) - type — income or expense - categoryId — UUID of category Create Transaction Required: typ","descriptionLabel":"Technical summary","evidenceSummary":"Published capability contract available. No trust telemetry is available yet. Last updated 4/15/2026.","installCommand":"git clone https://github.com/qepo17/koin.git","sourceUrl":"https://github.com/qepo17/koin","homepage":null,"primaryLinks":[{"label":"View Source","url":"https://github.com/qepo17/koin","kind":"source"}],"safetyScore":100,"overallRank":31.72,"popularityScore":0,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Koin Finance API Skill Koin Finance API Skill Manage personal finances through the Koin API. Configuration Set these environment variables before using: Authent"},"coverage":{"evidence":{"source":"capability-contract + public-profile","verified":true,"confidence":"high","updatedAt":"2026-02-24T19:43:53.720Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[{"label":"now","status":"self-declared"}],"verifiedCount":0,"selfDeclaredCount":2,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"},{"key":"now","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile capability:now|supported|profile"}},"adoption":{"evidence":{"source":"no-adoption-signals","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"No source adoption metrics were available."},"stars":0,"forks":0,"downloads":null,"packageName":null,"latestVersion":null,"tractionLabel":null},"release":{"evidence":{"source":"agent-index","verified":false,"confidence":"medium","updatedAt":"2026-02-23T21:26:52.831Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T05:21:22.124Z","lastCrawledAt":"2026-02-23T21:26:52.831Z","lastIndexedAt":null,"nextCrawlAt":"2026-02-24T21:26:52.831Z","lastVerifiedAt":null,"highlights":[]},"execution":{"evidence":{"source":"capability-contract","verified":true,"confidence":"high","updatedAt":"2026-02-24T19:43:53.720Z","emptyReason":null},"installCommand":"git clone https://github.com/qepo17/koin.git","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"ready","authModes":["api_key"],"requires":["openclew","lang:typescript"],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":"https://github.com/qepo17/koin#input","outputSchemaRef":"https://github.com/qepo17/koin#output","dataRegion":"global","contractUpdatedAt":"2026-02-24T19:43:53.720Z","sourceUpdatedAt":"2026-02-24T19:43:53.720Z","freshnessSeconds":19592961},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/qepo17-koin/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/qepo17-koin/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/qepo17-koin/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/qepo17-koin/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/qepo17-koin/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/qepo17-koin/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"GITHUB_OPENCLEW","generatedAt":"2026-10-09T14:13:15.445Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/qepo17-koin/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/qepo17-koin/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/qepo17-koin/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/qepo17-koin/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":[],"safeUseWhen":["Contract is available with explicit auth and schema references.","Trust confidence is not low and verification freshness is acceptable."],"riskFlags":["trust_data_unavailable"],"operationalConfidence":"medium"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"GITHUB OPENCLEW","verified":false,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"readme":"# Koin Finance API Skill\n\nManage personal finances through the Koin API.\n\n## Configuration\n\nSet these environment variables before using:\n```bash\nexport KOIN_API_URL=\"{{API_URL}}\"\nexport KOIN_API_TOKEN=\"<your-token-here>\"\n```\n\n## Authentication\n\nAll requests require the Bearer token:\n```bash\ncurl -H \"Authorization: Bearer $KOIN_API_TOKEN\" \"$KOIN_API_URL/endpoint\"\n```\n\n## Endpoints\n\n### Transactions\n\n#### List Transactions\n```bash\ncurl -H \"Authorization: Bearer $KOIN_API_TOKEN\" \\\n  \"$KOIN_API_URL/transactions?startDate=2024-01-01&endDate=2024-12-31&type=expense\"\n```\n\nQuery params:\n- `startDate` — ISO datetime filter (inclusive)\n- `endDate` — ISO datetime filter (inclusive)\n- `type` — `income` or `expense`\n- `categoryId` — UUID of category\n\n#### Create Transaction\n```bash\ncurl -X POST -H \"Authorization: Bearer $KOIN_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  \"$KOIN_API_URL/transactions\" \\\n  -d '{\n    \"type\": \"expense\",\n    \"amount\": \"25.50\",\n    \"description\": \"Lunch at cafe\",\n    \"categoryId\": \"uuid-here\",\n    \"date\": \"2024-01-15T12:00:00Z\"\n  }'\n```\n\nRequired: `type`, `amount`\n- `type` — `income` or `expense`\n- `amount` — positive decimal value\n\nOptional: `description`, `categoryId`, `date` (defaults to now)\n\n**Note:** For balance corrections or adjustments, use the Koin web UI.\n\n#### Get Transaction\n```bash\ncurl -H \"Authorization: Bearer $KOIN_API_TOKEN\" \"$KOIN_API_URL/transactions/:id\"\n```\n\n#### Update Transaction\n```bash\ncurl -X PATCH -H \"Authorization: Bearer $KOIN_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  \"$KOIN_API_URL/transactions/:id\" \\\n  -d '{\"amount\": \"30.00\"}'\n```\n\n#### Delete Transaction\n```bash\ncurl -X DELETE -H \"Authorization: Bearer $KOIN_API_TOKEN\" \"$KOIN_API_URL/transactions/:id\"\n```\n\n### Categories\n\n#### List Categories\n```bash\ncurl -H \"Authorization: Bearer $KOIN_API_TOKEN\" \"$KOIN_API_URL/categories\"\n```\n\n#### Create Category\n```bash\ncurl -X POST -H \"Authorization: Bearer $KOIN_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  \"$KOIN_API_URL/categories\" \\\n  -d '{\n    \"name\": \"Food & Dining\",\n    \"description\": \"Restaurants, groceries, coffee\",\n    \"color\": \"#ef4444\"\n  }'\n```\n\nRequired: `name`\nOptional: `description`, `color` (hex format)\n\n#### Update Category\n```bash\ncurl -X PATCH -H \"Authorization: Bearer $KOIN_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  \"$KOIN_API_URL/categories/:id\" \\\n  -d '{\"color\": \"#22c55e\"}'\n```\n\n#### Delete Category\n```bash\ncurl -X DELETE -H \"Authorization: Bearer $KOIN_API_TOKEN\" \"$KOIN_API_URL/categories/:id\"\n```\n\n### Summary\n\n#### Get Financial Summary\n```bash\ncurl -H \"Authorization: Bearer $KOIN_API_TOKEN\" \\\n  \"$KOIN_API_URL/summary?startDate=2024-01-01&endDate=2024-01-31\"\n```\n\nReturns:\n```json\n{\n  \"data\": {\n    \"income\": 5000.00,\n    \"expenses\": 2500.00,\n    \"adjustments\": 100.00,\n    \"balance\": 2600.00,\n    \"byCategory\": [\n      {\"categoryId\": \"...\", \"categoryName\": \"Food\", \"total\": \"500.00\", \"count\": 15}\n    ]\n  }\n}\n```\n\nBalance formula: `income - expenses + adjustments`\n\nNote: `adjustments` are balance corrections made via the web UI.\n\n### AI Commands\n\nUse natural language to bulk update transactions. Commands are staged for review before execution.\n\n#### Create Command (Interpret & Preview)\n```bash\ncurl -X POST -H \"Authorization: Bearer $KOIN_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  \"$KOIN_API_URL/ai/command\" \\\n  -d '{\"prompt\": \"Put all coffee expenses in Food category\"}'\n```\n\nReturns:\n```json\n{\n  \"data\": {\n    \"commandId\": \"uuid\",\n    \"interpretation\": \"I'll categorize transactions containing 'coffee' as Food.\",\n    \"preview\": {\n      \"matchCount\": 5,\n      \"records\": [\n        {\n          \"id\": \"tx-uuid\",\n          \"before\": {\"description\": \"Coffee\", \"category\": null, \"amount\": \"5.50\"},\n          \"after\": {\"description\": \"Coffee\", \"category\": \"Food\", \"amount\": \"5.50\"}\n        }\n      ]\n    },\n    \"expiresIn\": 300\n  }\n}\n```\n\n#### Get Command Status\n```bash\ncurl -H \"Authorization: Bearer $KOIN_API_TOKEN\" \"$KOIN_API_URL/ai/command/:id\"\n```\n\n#### Confirm Command (Execute)\n```bash\ncurl -X POST -H \"Authorization: Bearer $KOIN_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  \"$KOIN_API_URL/ai/command/:id/confirm\" \\\n  -d '{}'\n```\n\nReturns:\n```json\n{\n  \"data\": {\n    \"commandId\": \"uuid\",\n    \"status\": \"confirmed\",\n    \"updatedCount\": 5,\n    \"message\": \"Successfully updated 5 transaction(s)\"\n  }\n}\n```\n\n#### Cancel Command\n```bash\ncurl -X POST -H \"Authorization: Bearer $KOIN_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  \"$KOIN_API_URL/ai/command/:id/cancel\" \\\n  -d '{}'\n```\n\n**Supported filters:** description, amount, amount range, date range, category name, transaction type\n\n**Supported changes:** category, amount, description, type\n\n**Rate limit:** 10 requests per minute per user\n\n**Note:** Commands expire after 5 minutes (300 seconds) if not confirmed.\n\n### Settings\n\n#### Get User Settings\n```bash\ncurl -H \"Authorization: Bearer $KOIN_API_TOKEN\" \"$KOIN_API_URL/settings\"\n```\n\nReturns:\n```json\n{\n  \"data\": {\n    \"currency\": \"USD\",\n    \"name\": \"John Doe\"\n  }\n}\n```\n\n#### Update User Settings\n```bash\ncurl -X PATCH -H \"Authorization: Bearer $KOIN_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  \"$KOIN_API_URL/settings\" \\\n  -d '{\"currency\": \"EUR\"}'\n```\n\nOptional fields: `currency` (3-char code, e.g., USD, EUR, IDR), `name`\n\n## Common Tasks\n\n### Log an expense\n```bash\ncurl -X POST -H \"Authorization: Bearer $KOIN_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  \"$KOIN_API_URL/transactions\" \\\n  -d '{\"type\": \"expense\", \"amount\": \"15.00\", \"description\": \"Coffee\"}'\n```\n\n### Log income\n```bash\ncurl -X POST -H \"Authorization: Bearer $KOIN_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  \"$KOIN_API_URL/transactions\" \\\n  -d '{\"type\": \"income\", \"amount\": \"3000.00\", \"description\": \"Salary\"}'\n```\n\n### Check this month's spending\n```bash\nSTART=$(date -d \"$(date +%Y-%m-01)\" +%Y-%m-%dT00:00:00Z)\nEND=$(date +%Y-%m-%dT23:59:59Z)\ncurl -H \"Authorization: Bearer $KOIN_API_TOKEN\" \"$KOIN_API_URL/summary?startDate=$START&endDate=$END\"\n```\n\n## Response Format\n\nAll responses follow:\n```json\n{\n  \"data\": { ... }\n}\n```\n\nErrors:\n```json\n{\n  \"error\": \"Error message or validation issues\"\n}\n```\n\n## Setup Instructions\n\n1. Copy this file to your AI agent's workspace (e.g., `skills/koin/SKILL.md`)\n2. The API_URL above is pre-configured for your account\n3. Create an API token in Settings → API Tokens, then set KOIN_API_TOKEN\n4. Your agent can now manage your finances using the endpoints above\n","readmeExcerpt":"Koin Finance API Skill Manage personal finances through the Koin API. Configuration Set these environment variables before using: Authentication All requests require the Bearer token: Endpoints Transactions List Transactions Query params: - startDate — ISO datetime filter (inclusive) - endDate — ISO datetime filter (inclusive) - type — income or expense - categoryId — UUID of category Create Transaction Required: typ","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"export KOIN_API_URL=\"{{API_URL}}\"\nexport KOIN_API_TOKEN=\"<your-token-here>\""},{"language":"bash","snippet":"curl -H \"Authorization: Bearer $KOIN_API_TOKEN\" \"$KOIN_API_URL/endpoint\""},{"language":"bash","snippet":"curl -H \"Authorization: Bearer $KOIN_API_TOKEN\" \"$KOIN_API_URL/endpoint\""},{"language":"bash","snippet":"curl -H \"Authorization: Bearer $KOIN_API_TOKEN\" \\"},{"language":"bash","snippet":"curl -H \"Authorization: Bearer $KOIN_API_TOKEN\" \\\n  \"$KOIN_API_URL/transactions?startDate=2024-01-01&endDate=2024-12-31&type=expense\""},{"language":"bash","snippet":"curl -X POST -H \"Authorization: Bearer $KOIN_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\"}],"parameters":{},"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["typescript"],"docsSourceLabel":"GITHUB OPENCLEW","editorialOverview":"Koin Finance API Skill Koin Finance API Skill Manage personal finances through the Koin API. Configuration Set these environment variables before using: Authentication All requests require the Bearer token: Endpoints Transactions List Transactions Query params: - startDate — ISO datetime filter (inclusive) - endDate — ISO datetime filter (inclusive) - type — income or expense - categoryId — UUID of category Create Transaction Required: typ","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":345,"uniquenessScore":72,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T14:13:15.445Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/github_openclew","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}