Description

Use when users want to subscribe, pay, or manage Crypto Listing Alert notifications for exchange listing events and need Telegram, Discord, or Email delivery...

README (SKILL.md)

Crypto Listing Alert Skill

Name: Crypto Listing Alert
Author: xyz-ass

Use this skill for Crypto Listing Alert subscription operations: listing alert subscribe, payment order management, status query, and unsubscribe.

Search keywords: 币安,binance,okx,crypto,Crypto Listing Alert, exchange listing, listing alert, 上币提醒, 交易所上新, 新币通知, 邮箱订阅, Telegram, Discord, 支付订单, 订阅状态.

Supported exchanges: Binance, OKX, Bybit, Bitget.

The skill uses the node skills/crypto-listing-alert/index.cjs CLI tool to communicate with the backend API.

When To Use

User says: "我要订阅上币提醒 / 交易所上新通知 / crypto listing alert"
User asks to pay, continue pending order, check payment, or cancel order
User asks to check active subscription or unsubscribe
User needs channel recommendation with priority: Telegram/Discord first, Email optional fallback

Quick Intents

User intent	Command path
看套餐/价格	`plans --json`
创建订阅支付单	`list-orders --status pending --json` -> `pay ... --json`
继续支付订单	`check-payment --order-id \x3CID> --json`
取消未支付订单	`cancel-order --order-id \x3CID> --json`
查询订阅状态	`status --json`
取消订阅	`unsubscribe --json`

Channel Routing

Priority is telegram / discord first, then email as optional fallback
If user context is Telegram: default channel=telegram
If user context is Discord: default channel=discord
If user context is NOT Telegram/Discord: ask user preference, recommend Telegram/Discord first; use channel=email if user chooses email or lacks Telegram/Discord setup
Do not force channel choice

Precondition

Before doing any subscription/payment action, always check login state first.

Run:

node skills/crypto-listing-alert/index.cjs check-login --json

If logged_in = true: proceed normally.
If logged_in = false: immediately guide user to get API key from website first, then login:
1. Visit https://listingalert.org
2. Register/login and generate API key
3. Run:
```
node skills/crypto-listing-alert/index.cjs login --api-key \x3CKEY> --json
```

Do not continue subscription/payment commands before login is ready.

Important Operating Rules

Always use --json flag when calling the CLI.
First-time setup flow:
- User must first login website and generate API key at https://listingalert.org.
- Check local login state via check-login --json.
- If not logged in, run: node skills/crypto-listing-alert/index.cjs login --api-key \x3CKEY> --json
Payment flow for paid plans (recommended):
- First check pending orders with list-orders --status pending --json.
- If pending orders exist, ask user: "你有未支付的订单（订单号：XXX，金额：XXX USDT），是要继续支付该订单，还是取消后重新创建？"
  - If user chooses 继续支付: run check-payment --order-id \x3CID> --json
  - If user chooses 取消: run cancel-order --order-id \x3CID> --json then create new order
- Use pay command to create new payment order after pending-order decision
- Show payment amount, wallet address, and QR image link
- Use check-payment to wait for confirmation
- Once confirmed, subscription is automatically activated
Before calling pay, collect all required fields:
- Plan code
- Exchanges (comma-separated lowercase)
- Billing cycle (monthly or yearly)
- Channel (telegram or discord or email) - auto-detect from current user environment/message context
- Channel recommendation priority: Telegram/Discord first; Email is optional fallback
- Telegram channel needs telegram_chat_id + bot_token
- Discord channel needs discord_channel_id + bot_token
- Email channel needs email
Credential sources (must follow):
- telegram.chatId: parse from current message body/context metadata.
- telegram.botToken: read from openclaw config file.
- discord.botToken: read from openclaw config file.
- discord.channelId: read from openclaw config file.
- email: prefer current logged-in account email; if user provides another valid email, use user input.
- If any required value is missing, tell user to fix config/source first.
Never guess API key, bot token, chat/channel ID, or email.
Error handling: if command returns JSON error, show it clearly to user.
Exchanges must be lowercase comma-separated values.

Capabilities

0) Check login state

node skills/crypto-listing-alert/index.cjs check-login --json

Expected response (example):

{
  "logged_in": true,
  "api_url": "https://listingalert.org/api",
  "config_path": ".../.exchange-alerts/config.json"
}

1) Login / Setup

node skills/crypto-listing-alert/index.cjs login --api-key \x3CAPI_KEY> --json

Optional custom server:

node skills/crypto-listing-alert/index.cjs login --api-key \x3CAPI_KEY> --api-url \x3CURL> --json

2) List available plans

node skills/crypto-listing-alert/index.cjs plans --json

Present plans clearly (plan, monthly/yearly price, exchanges, signal types, limits).

3) List payment orders

node skills/crypto-listing-alert/index.cjs list-orders --status pending --json

Optional flags:

--status \x3Cpending|paid|expired|cancelled>

If there is an order id, generate QR image URL as:

qr_url = \x3Capi_url>/payments/\x3Corder_id>/qr

Then wrap per messaging channel:

Telegram: [点击查看支付二维码](\x3Cqr_url>) or direct image URL.
Discord: ![payment-qr](\x3Cqr_url>) and fallback \x3Cqr_url>.

3a) Cancel a payment order

node skills/crypto-listing-alert/index.cjs cancel-order --order-id \x3CORDER_ID> --json

4) Create payment order (RECOMMENDED for paid plans)

Channel should be auto-detected from current user environment:

If current user is from Telegram context, use --channel telegram
If current user is from Discord context, use --channel discord
If current user is NOT from Telegram/Discord context, ask preference and recommend Telegram/Discord first
Use --channel email when user chooses Email or cannot use Telegram/Discord
Do not force channel choice

Telegram command template:

node skills/crypto-listing-alert/index.cjs pay --plan \x3CPLAN_CODE> --exchanges \x3CEXCHANGE_CSV> --billing \x3Cmonthly|yearly> --channel telegram --telegram \x3CCHAT_ID> --bot-token \x3CTOKEN> --json

Discord command template:

node skills/crypto-listing-alert/index.cjs pay --plan \x3CPLAN_CODE> --exchanges \x3CEXCHANGE_CSV> --billing \x3Cmonthly|yearly> --channel discord --discord-channel \x3CCHANNEL_ID> --bot-token \x3CTOKEN> --json

Email command template:

node skills/crypto-listing-alert/index.cjs pay --plan \x3CPLAN_CODE> --exchanges \x3CEXCHANGE_CSV> --billing \x3Cmonthly|yearly> --channel email --email \x3CEMAIL> --json

Use server returned order.qr_url first; if absent, build via \x3Capi_url>/payments/\x3Cid>/qr.

Then wrap per channel:

Telegram: [点击查看支付二维码](\x3Cqr_url>)
Discord: ![payment-qr](\x3Cqr_url>) plus \x3Cqr_url> fallback

5) Check payment status

node skills/crypto-listing-alert/index.cjs check-payment --order-id \x3CORDER_ID> --json

Optional flags:

--wait \x3CSECONDS> (default 300)

Behavior:

Poll every 10 seconds
Wait for chain confirmation
Return on paid/expired/timeout

After success:

Tell user subscription is active
Show expiry date
Give channel-specific delivery reminder

6) Create subscription (compat/free use)

Telegram:

node skills/crypto-listing-alert/index.cjs subscribe --plan \x3CPLAN_CODE> --exchanges \x3CEXCHANGE_CSV> --billing \x3Cmonthly|yearly> --channel telegram --telegram \x3CCHAT_ID> --bot-token \x3CTOKEN> --json

Discord:

node skills/crypto-listing-alert/index.cjs subscribe --plan \x3CPLAN_CODE> --exchanges \x3CEXCHANGE_CSV> --billing \x3Cmonthly|yearly> --channel discord --discord-channel \x3CCHANNEL_ID> --bot-token \x3CTOKEN> --json

Email:

node skills/crypto-listing-alert/index.cjs subscribe --plan \x3CPLAN_CODE> --exchanges \x3CEXCHANGE_CSV> --billing \x3Cmonthly|yearly> --channel email --email \x3CEMAIL> --json

7) Check subscription status

node skills/crypto-listing-alert/index.cjs status --json

If subscription is null, inform user no active subscription and suggest viewing plans.

8) Cancel subscription

node skills/crypto-listing-alert/index.cjs unsubscribe --json

Payment Flow (Recommended)

Check login state -> check-login --json
Show plans -> plans --json
Check pending orders -> list-orders --status pending --json
- If pending exists: ask continue vs cancel
Create payment order -> pay ... --json
Show:
- exact USDT amount
- wallet address
- wrapped QR image link (Telegram/Discord specific)
- exact-amount warning
Wait for payment -> check-payment --order-id \x3CID> --json
Confirm success and remind delivery prerequisites

Channel Delivery Notes

Telegram

User must have started chat with their configured bot (e.g. /start) or alerts may fail.

Discord

Bot must already be in target server and have permission to send messages in target channel.

Troubleshooting

Error	Solution
"not logged in"	Run `check-login --json`, then `login --api-key \x3CKEY> --json`
"Invalid API key"	API key is wrong or revoked; regenerate from website
"You already have an active subscription"	Cancel with `unsubscribe` or verify existing subscription
"Exchange not allowed in this plan"	Choose a plan that includes the exchange
"You already have a pending payment order"	Use `list-orders --status pending --json`, continue paying or cancel first
"Payment order expired"	Create a new payment order
Payment not confirming	Verify exact amount, wallet address, network (BSC), token (USDT BEP-20)
Missing bot/chat/channel/email config	Read from required source (openclaw config or message context), ask user to fix config

Usage Guidance

This skill appears to implement subscription and payment flows for an external service (listingalert.org) and will save an API key to ~/.exchange-alerts/config.json. However the SKILL.md asks the agent to pull Telegram/Discord bot tokens, channel IDs, and chat IDs from an "openclaw" config and message context — sensitive credentials that are not declared in the manifest and are not obviously required by the included CLI (the CLI expects explicit flags). Before installing: 1) Ask the author to clarify where/how bot tokens and channel IDs are obtained and to declare any config paths or env vars. 2) Inspect index.cjs yourself (or in a sandbox) to confirm it does not read other agent configs or exfiltrate secrets. 3) Avoid granting the agent access to other skills' tokens or global config; prefer providing bot tokens/IDs explicitly and only when necessary. 4) Be aware the skill will write ~/.exchange-alerts/config.json with the API key. If you cannot verify the author or behavior, run it in an isolated environment or decline installation.

Capability Analysis

Type: OpenClaw Skill Name: crypto-listing-alert Version: 1.0.2 The skill facilitates crypto listing alerts by interacting with an external API (listingalert.org) and requires high-privilege credentials, including Telegram/Discord bot tokens and API keys. The SKILL.md instructions explicitly direct the AI agent to extract these sensitive tokens from local configuration files and pass them as command-line arguments to the index.cjs script, which then transmits them to the backend. While this behavior is consistent with the stated purpose of a notification service, the handling of raw bot tokens and the instruction for the agent to access local secrets represent a significant security risk and potential for credential exfiltration.

Capability Assessment

⚠ Purpose & Capability

Name/description (subscribe/pay/manage crypto listing alerts) aligns with the provided CLI tool (index.cjs). However SKILL.md asks the agent to obtain Telegram/Discord bot tokens and channel IDs from an 'openclaw config file' and to parse chat IDs from message context metadata; those cross-skill/agent config accesses are not declared in the skill metadata and are disproportionate to the claimed requirements.

⚠ Instruction Scope

Runtime instructions direct the agent to read bot tokens and channel IDs from an OpenClaw config and to parse chat IDs from current message context. The included CLI actually expects explicit flags (e.g. --bot-token, --telegram) and the code saves/reads its own config at ~/.exchange-alerts/config.json. The SKILL.md therefore asks the agent to access agent/system-level config and runtime message metadata that aren't referenced in the code or declared in the skill manifest.

ℹ Install Mechanism

No install spec (instruction-only) but the package includes an executable Node script (index.cjs). No external downloads; script runs via node. The script reads/writes a config file under the user's home (.exchange-alerts/config.json) which is expected behaviour but should be noted.

⚠ Credentials

Skill metadata declares no required env vars or credentials, but SKILL.md instructs the agent to retrieve Telegram/Discord bot tokens and channel IDs from an OpenClaw config and parse chat IDs from message context; those are sensitive credentials and cross-skill reads are not declared. The primary API key for listingalert.org is reasonable, but the implicit requirement to access other skills' tokens is disproportionate and not documented in requires.env or config paths.

ℹ Persistence & Privilege

The skill does persist the service API key in a config file under the user's home (~/.exchange-alerts/config.json) when the login command is used. always is false and autonomous invocation is allowed (default). No evidence the skill modifies other skills or global agent settings, but the instruction to read OpenClaw config suggests potential cross-skill config access which is not implemented or declared.

Version History

v1.0.2

- Changed the API key registration/login website from https://noteagent.ai to https://listingalert.org. - Updated all mentions of the API server base URL in instructional examples to https://listingalert.org. - No changes to commands, functionality, or operational rules.

v1.0.1

crypto-listing-alert 1.0.1 - Refined description and key search terms for improved discoverability. - Reorganized and simplified instructions, focusing on user intent and quick command mapping. - Updated supported exchanges (removed Gate, KuCoin; added Bitget). - Clarified channel selection rules: Telegram/Discord prioritized, Email as fallback (not forced). - Improved "When To Use" and operational flow guidance while retaining all main capabilities.

v1.0.0

crypto-listing-alert 1.0.0 is a significant update with broader delivery and exchange support, plus enhanced usability: - Adds Email as an alert delivery option alongside Telegram and Discord. - Adds Bitget as a supported exchange (replacing KuCoin in the description). - Updates payment and subscription flows to auto-detect and recommend the appropriate delivery channel based on user context. - Changes the API website to noteagent.ai for registration and API key management. - Enhances user guidance for credential sourcing and error handling in Email, Telegram, and Discord contexts.

v0.4.0

crypto-listing-alert v1.0.0 - Initial public release with full subscription and payment flows for real-time crypto exchange listing alerts. - Supports Binance, OKX, Bybit, Gate, and KuCoin alerts delivered to Telegram or Discord. - USDT (BSC) crypto payments, with management of plans, payment orders, and QR code generation. - Strict CLI operating rules for login, API key handling, and channel credential sourcing. - Comprehensive troubleshooting steps and error handling included.

Metadata

Slug crypto-listing-alert

Version 1.0.2

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 4

Frequently Asked Questions

What is Crypto Listing Alert?

Use when users want to subscribe, pay, or manage Crypto Listing Alert notifications for exchange listing events and need Telegram, Discord, or Email delivery... It is an AI Agent Skill for Claude Code / OpenClaw, with 114 downloads so far.

How do I install Crypto Listing Alert?

Run "/install crypto-listing-alert" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Crypto Listing Alert free?

Yes, Crypto Listing Alert is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Crypto Listing Alert support?

Crypto Listing Alert is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Crypto Listing Alert?

It is built and maintained by syx-ass (@xyz-ass); the current version is v1.0.2.

More Skills

Crypto Listing Alert