# Send Crypto Alert Agent to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "crypto-alert-agent",
    "name": "Crypto Alert Agent",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/Vitja1988/crypto-alert-agent",
    "canonicalUrl": "https://clawhub.ai/Vitja1988/crypto-alert-agent",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/crypto-alert-agent",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=crypto-alert-agent",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "crypto-alert-agent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T22:19:47.259Z",
      "expiresAt": "2026-05-07T22:19:47.259Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=crypto-alert-agent",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=crypto-alert-agent",
        "contentDisposition": "attachment; filename=\"crypto-alert-agent-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "crypto-alert-agent"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/crypto-alert-agent"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/crypto-alert-agent",
    "downloadUrl": "https://openagent3.xyz/downloads/crypto-alert-agent",
    "agentUrl": "https://openagent3.xyz/skills/crypto-alert-agent/agent",
    "manifestUrl": "https://openagent3.xyz/skills/crypto-alert-agent/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/crypto-alert-agent/agent.md"
  }
}
```
## Documentation

### 📈 Crypto Alert Agent

Stay ahead of the market with the Crypto Alert Agent. This skill provides real-time price alerts, portfolio tracking, and instant notifications through Telegram, ensuring you never miss a critical market movement.

Supported cryptocurrencies include BTC, ETH, SOL, and many more via the CoinGecko API.

### 1. Features

Price Alerts: Set custom price thresholds for any supported cryptocurrency. Get notified when the price goes above or below your target.
Portfolio Tracking: Add your crypto holdings to track their total value in real-time.
Telegram Notifications: Receive all alerts and updates directly in your Telegram chat for immediate action.
On-Demand Price Checks: Instantly fetch the current price of any cryptocurrency.

### 2. Setup

Before using the agent, you need to configure your Telegram notifications.

Get your Telegram Chat ID:

Talk to the @userinfobot on Telegram.
It will give you your unique Chat ID.



Set up Credentials:

Create a file named telegram_chat_id inside the {baseDir}/credentials/ directory.
Paste your Chat ID into this file.
Ensure your OpenClaw instance is configured with a Telegram bot token that has permission to send you messages.

### 3. Usage

The agent can be managed through a simple command-line interface. All commands are executed via the run.sh script.

### 3.1 Price Alerts

Add a Price Alert

Set an alert for a specific coin when it crosses a target price.

Command:

bash {baseDir}/run.sh alert add --coin <id> --condition <above|below> --price <usd_price>

--coin <id>: The CoinGecko API ID for the cryptocurrency (e.g., bitcoin, ethereum, solana).
--condition <above|below>: Notify when the price is above or below the target.
--price <usd_price>: The target price in USD.

Example:

# Alert me when Bitcoin goes above $75,000
bash {baseDir}/run.sh alert add --coin bitcoin --condition above --price 75000

# Alert me when Solana drops below $150
bash {baseDir}/run.sh alert add --coin solana --condition below --price 150

List Active Alerts

View all the price alerts you have currently set.

bash {baseDir}/run.sh alert list

Remove a Price Alert

Delete an active alert using its ID (you can get the ID from the list command).

bash {baseDir}/run.sh alert remove --id <alert_id>

### 3.2 Portfolio Tracking

Add a Holding to Your Portfolio

Add a coin and the amount you hold to your portfolio.

Command:

bash {baseDir}/run.sh portfolio add --coin <id> --amount <quantity>

--coin <id>: The CoinGecko API ID of the coin.
--amount <quantity>: The number of coins you hold.

Example:

bash {baseDir}/run.sh portfolio add --coin ethereum --amount 2.5

View Your Portfolio

Get a summary of your current holdings and their total value in USD.

bash {baseDir}/run.sh portfolio view

Remove a Holding from Your Portfolio

Remove a coin from your portfolio using its ID.

bash {baseDir}/run.sh portfolio remove --id <holding_id>

### 3.3 Check Price

Get the current price of one or more cryptocurrencies instantly.

Command:

bash {baseDir}/run.sh price --coins <id1,id2,...>

--coins <id1,id2,...>: A comma-separated list of CoinGecko API IDs.

Example:

bash {baseDir}/run.sh price --coins bitcoin,ethereum,solana

### 4. Automation (Agent Logic)

This skill is designed to be run on a schedule (e.g., via a cron job or a persistent agent loop) to check for alert conditions.

Recommended Automation Schedule: Every 5 minutes.

Example Cron Job:

*/5 * * * * /path/to/your/workspace/skills/crypto-alert-agent/run.sh agent run

The agent run command will:

Fetch the latest prices for all coins in active alerts and the portfolio.
Check if any price alert conditions have been met.
If an alert is triggered, send a notification to the configured Telegram chat ID and remove the alert to avoid spam.
(Optional) Send a periodic portfolio value update.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Vitja1988
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T22:19:47.259Z
- Expires at: 2026-05-07T22:19:47.259Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/crypto-alert-agent)
- [Send to Agent page](https://openagent3.xyz/skills/crypto-alert-agent/agent)
- [JSON manifest](https://openagent3.xyz/skills/crypto-alert-agent/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/crypto-alert-agent/agent.md)
- [Download page](https://openagent3.xyz/downloads/crypto-alert-agent)