Xpersona
H

Hodl Dance Skill

CLAWHUB · Unverified

Trade, create, and manage memecoins on HODL.DANCE's BSC bonding curve launchpad. Launch tokens with logo upload and optional initial buy, get live quotes, bu... Skill: Hodl Dance Skill Owner: hodldance Summary: Trade, create, and manage memecoins on HODL.DANCE's BSC bonding curve launchpad. Launch tokens with logo upload and optional initial buy, get live quotes, bu... Tags: bonding-curve:1.1.0, bsc:1.1.0, defi:1.1.0, latest:1.3.1, memecoin:1.1.0, trading:1.1.0 Version history: v1.3.1 | 2026-05-27T00:38:06.142Z | user Fix: ethers dependency (v5 → v6). Version 1.3.0 was broke

62
Rank
84
Safety
995
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 995 downloads reported by the source. Last updated 10/11/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: low.

clawhub skill install s17em12e927j9ee5ee7n7x93d586tqkx:hodl-dance
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. 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: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-hodldance-hodl-dance/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

144,980 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

# HODL.DANCE Agent Skill

Trade memecoins on the [HODL.DANCE](https://hodl.dance) bonding curve launchpad on BSC (BNB Chain).

## Overview

HODL.DANCE is a memecoin launchpad on BSC using a CPMM bonding curve (r × t = k).
Tokens trade on the curve until 19 BNB is raised, then liquidity auto-migrates to PancakeSwap V3.

- **Network:** BSC Mainnet (Chain ID: 56)
- **Native currency:** BNB
- **Fee:** 1% per trade (buy and sell)
- **API:** [https://hodl.dance/api](https://hodl.dance/api) (public, no API key required)
- **Docs:** [https://docs.hodl.dance](https://docs.hodl.dance)

## Installation

```bash
npm install -g @hodl-dance/skill
# or without installing:
npx @hodl-dance/skill <command>
```

## Credentials

Required only for `create-token`, `buy-token` and `sell-token`:

```bash
export HODL_PRIVATE_KEY=0xyour_private_key
export HODL_RPC_URL=https://bsc-dataseed.binance.org/  # optional
```

> ⚠️ The private key is used locally only to sign transactions. Never share it.

---

## Commands

### `get-tokens`

List tokens with filtering and sorting. Returns full token objects including `bonding_curve_address`.

```bash
hodl-skill get-tokens
hodl-skill get-tokens --sort=market_cap --limit=10
hodl-skill get-tokens --sort=volume --verified=true
hodl-skill get-tokens --sort=progress --finalized=false
hodl-skill get-tokens --search=pepe --limit=5
```

**Options:** `--sort=newest|market_cap|progress|volume` · `--limit=N` (max 100) · `--offset=N` · `--verified=true|false` · `--finalized=true|false` · `--search=<text>`

**Key output fields per token:**
- `address` — token contract address
- `bonding_curve_address` — ⭐ use this in quote/buy-token/sell-token
- `market_cap_usd`, `progress_percent` (0–100 toward PancakeSwap migration)
- `finalized` — if true, bonding curve is closed, token is on PancakeSwap V3
- `price_change_24h`, `trades_24h`, `volume_24h_bnb`

---

### `get-token <tokenAddress>`

Full token details + 20 most recent trades.

```bash
hodl-skill get-token 0x1a2b3c...
```

Returns same fields as `get-tokens` plus `recent_trades[]`.

---

### `get-trades <tokenAddress>`

Trade history for a specific token.

```bash
hodl-skill get-trades 0x1a2b3c...
hodl-skill get-trades 0x1a2b3c... --type=buy --limit=20
```

**Options:** `--type=all|buy|sell` · `--limit=N` (max 500) · `--offset=N`

---

### `quote <bondingCurveAddress> buy|sell <amount>`

**Simulate** trade output using live on-chain state. No transaction sent, no gas used.

```bash
# How many tokens will I get for 0.1 BNB?
hodl-skill quote 0xbc1234... buy 0.1

# How much BNB will I get for selling 500000 tokens?
hodl-skill quote 0xbc1234... sell 500000
```

> Always run `quote` before `buy-token` or `sell-token` to verify expected amounts.

---

### `create-token`

Deploy a new token + bonding curve on HODL.DANCE. Uploads logo to IPFS, then sends on-chain transaction.

```bash
hodl-skill create-token --name="Moon Cat" --symbol=MCAT --logo=./logo.png

hodl-skill create-token \
  --name="Moon Cat"

README.md

# 🪩 HODL.DANCE Agent Skill

**Official CLI skill for AI agents and trading bots to interact with [HODL.DANCE](https://hodl.dance) — the memecoin bonding curve launchpad on BSC.**

[![Version](https://img.shields.io/badge/version-1.3.0-1d9bf0)](https://www.npmjs.com/package/@hodl-dance/skill)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node](https://img.shields.io/badge/Node-%3E%3D18-green)](https://nodejs.org/)

---

## The Problem

Most AI agents and trading bots want to trade memecoins on emerging launchpads, but:

- Bonding curve mechanics are complex to simulate correctly
- On-chain trading requires careful handling of approvals, gas, and errors
- Public APIs give data, but executing trades reliably is painful
- Most tools are built for humans, not autonomous agents

---

## The Solution

**@hodl-dance/skill** gives agents a clean, reliable, JSON-first interface to HODL.DANCE.

- Read market data, token details, and trade history
- Simulate buys and sells instantly (no gas, no transactions)
- Execute real buys and sells with automatic ERC20 approvals
- Launch new tokens directly from code or agents

**Built for agents. Works great for humans too.**

---

## ✨ Key Features

- **Pure JSON output** — Every command returns structured, machine-readable JSON
- **Gas-free simulations** — `quote` command uses on-chain state to predict exact output
- **Automatic approvals** — `sell-token` handles ERC20 `approve` when needed
- **Zero dependencies for reads** — Public commands work without any wallet or keys
- **Agent-native** — Designed for 8004 agents, ClawHub, and autonomous systems
- **Windows + Linux friendly** — Stable on both WSL and native Windows

---

## 🤖 AI Agents & 8004 Integration

This skill is the **official on-chain execution layer** for HODL.DANCE agents.

It is referenced in the platform's agent manifest:

- [Agent Card](https://hodl.dance/.well-known/agent-card.json)
- [OpenAPI Spec](https://hodl.dance/.well-known/openapi.json)

### Example Agent ID on 8004
- [HODL.DANCE Agent #96231](https://8004scan.io/agents/bsc/96231)

### Supported Workflows for Agents

```bash
# 1. Discovery
hodl-skill get-tokens --sort=volume --limit=10

# 2. Analysis
hodl-skill get-token <tokenAddress>
hodl-skill get-trades <tokenAddress> --type=buy --limit=20

# 3. Simulation (free)
hodl-skill quote <bondingCurveAddress> buy 0.1

# 4. Execution
hodl-skill buy-token <bondingCurveAddress> 0.1
hodl-skill sell-token <bondingCurveAddress> <amount>
```

More integration examples and agent card details: [docs.hodl.dance](https://docs.hodl.dance)

---

## 🚀 Installation

```bash
npm install -g @hodl-dance/skill
```

Or run without installing:

```bash
npx @hodl-dance/skill <command>
```

### Requirements

- Node.js ≥ 18
- For write commands (`buy`, `sell`, `create`): `HODL_PRIVATE_KEY` environment variable

---

## 📖 Usage

### Read Commands (no wallet required)

```bash
# List tokens
hodl-skill

_meta.json

{
  "ownerId": "kn70cw47asswh3p18g11rrjen586tg1s",
  "slug": "hodl-dance",
  "version": "1.3.1",
  "publishedAt": 1779842286142
}

CHANGELOG.md

# Changelog

All notable changes to `@hodl-dance/skill` will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

---

## [1.3.0] - 2026-05-27

### Added
- Full support for AI agent workflows and 8004 ecosystem integration
- New modern README with Problem/Solution structure and dedicated "AI Agents & 8004 Integration" section
- `CHANGELOG.md` for proper release tracking
- Basic address validation for all commands accepting Ethereum addresses (`get-token`, `get-trades`, `quote`, `buy-token`, `sell-token`)
- `stripMongoFields()` helper to consistently remove internal `_id` and `__v` fields from all public JSON output

### Changed
- **Breaking for output consumers**: `get-token`, `get-trades`, and nested trades now return clean objects without MongoDB internal fields (`_id`, `__v`)
- Improved Windows compatibility: replaced direct `process.exit()` calls with `process.exitCode` pattern to prevent libuv `UV_HANDLE_CLOSING` assertion crashes when output is captured
- Better error messages when invalid addresses are provided (now returns clear `INVALID_ARG` instead of downstream contract errors)
- Updated `get-tokens` to use the new sanitization helper for consistency

### Fixed
- Critical bug: CLI would crash with native assertion on Windows after every successful command when stdout was piped or captured (common in agent environments)
- Inconsistent presence of MongoDB metadata in JSON responses

### Technical
- Added `src/lib/validators.js` for reusable address validation
- Refactored output handling in `src/lib/output.js` and `src/index.js`

---

## [1.2.1] - Previous

- Documentation updates
- Minor fixes for `create-token` command

---

## [1.2.0]

- Added `create-token` command (token deployment + logo upload + optional initial buy)

---

## [1.1.0]

- Initial public release
- Commands: `get-tokens`, `get-token`, `get-trades`, `quote`, `buy-token`, `sell-token`

[1.3.0]: https://github.com/hodldance/agent-skill/compare/v1.2.1...v1.3.0

skill-card.md

## Description:

Helps agents read HODL.DANCE market data, simulate bonding-curve trades, execute BNB/token trades, and launch memecoins on the HODL.DANCE BSC launchpad.

This skill is ready for commercial/non-commercial use.

## Publisher:

[hodldance](https://clawhub.ai/user/hodldance)

### License/Terms of Use:

MIT-0

## Use Case:

Developers and agent operators use this skill to give agents a JSON-first CLI for discovering HODL.DANCE tokens, quoting bonding-curve trades, executing buy/sell transactions, and creating new tokens on BNB Chain.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Write commands can spend real BNB, deploy tokens, approve token transfers, or sell tokens when a private key is configured.

Mitigation: Use a dedicated low-value wallet, run read and quote commands first, and require human approval with strict amount limits before buy-token, sell-token, or create-token.

Risk: The create-token command uploads a local logo file and token metadata.

Mitigation: Restrict logo paths to an approved directory and review metadata before allowing an agent to run create-token.

Risk: Unpinned npx execution may install a package version other than the reviewed release.

Mitigation: Pin @hodl-dance/skill to version 1.3.1 or install from a locked package source.

## Reference(s):

- [ClawHub Skill Page](https://clawhub.ai/hodldance/skills/hodl-dance)
- [HODL.DANCE Documentation](https://docs.hodl.dance)
- [HODL.DANCE API](https://hodl.dance/api)
- [HODL.DANCE Agent Card](https://hodl.dance/.well-known/agent-card.json)
- [HODL.DANCE OpenAPI Spec](https://hodl.dance/.well-known/openapi.json)
- [NPM Package](https://www.npmjs.com/package/@hodl-dance/skill)

## Skill Output:

**Output Type(s):** [JSON, Shell commands, Configuration]

**Output Format:** [JSON to stdout, with command-line usage and environment variable guidance]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Write commands require HODL_PRIVATE_KEY and can submit BNB Chain transactions; read and quote commands do not require a wallet.]

## Skill Version(s):

1.3.1 (source: server release metadata; artifact package.json and CHANGELOG report 1.3.0)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Sponsored

Ads related to Hodl Dance Skill and adjacent AI workflows.