What makes ATXSwap notable?

1.4K downloads. Trust evidence available

How should ATXSwap be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

ATXSwap

Manage ATX on BSC with wallet creation, price and balance queries, PancakeSwap V3 swaps, liquidity operations, LP positions and holdings, and BNB/ERC20 trans...

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.4k

Updated

Oct 10, 2026

Version

0.0.31

Source

CLAWHUB

About

What it does, and when to use it.

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

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 10, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 10, 2026
Adoption signal: 1.4K downloadsadoption · observed Oct 10, 2026
Latest release: 0.0.31release · observed May 14, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17dmcmzd5ve77tjfb48rfpvxh84fqgh:atxswap

Install using `clawhub skill install s17dmcmzd5ve77tjfb48rfpvxh84fqgh:atxswap` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/agentswapx/atxswap before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-agentswapx-atxswap/snapshot"

Documentation

CLAWHUB

150,306 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: atxswap
description: >-
  Manage ATX on BSC with wallet creation, price and balance queries, PancakeSwap
  V3 swaps, liquidity operations, LP positions and holdings, and BNB/ERC20 transfers.
  Use when the user mentions ATX, BSC, PancakeSwap V3, wallet creation, price checks,
  buying, selling, liquidity, fees, holdings, LP positions, or token transfers.
version: "0.0.31"
compatibility: Requires Node.js 18+ and npm. Network access to BSC RPC required.
inject:
  - bash: echo "${CLAUDE_SKILL_DIR:-$(cd "$(dirname "$0")/.." && pwd)}"
    as: SKILL_DIR
metadata:
  author: agentswapx
  openclaw:
    requires:
      bins:
        - node
        - npm
    homepage: https://github.com/agentswapx/skills/tree/main/atxswap
    os:
      - linux
      - macos
---

# ATXSwap Skill

Execute ATX trading and wallet workflows on BSC. This skill is designed for
agents that need safe, repeatable commands for wallet management, ATX/USDT
quotes, swaps, V3 liquidity actions, and transfers.

- **SDK**: [`atxswap-sdk`](https://www.npmjs.com/package/atxswap-sdk) on npm ([source](https://github.com/agentswapx/atxswap-sdk))
- **Docs (team / project)**: [Team introduction (EN)](https://docs.atxswap.com/guide/team) · [Team introduction (ZH)](https://docs.atxswap.com/zh/guide/team)
- **Keystore dir**: `~/.config/atxswap/keystore` (fixed, not configurable)
- **Secrets dir**: `~/.config/atxswap/` (master.key + secrets.json)

## Use This Skill For

- Create the single wallet used by this skill instance (importing an existing private key is not supported)
- Query ATX price, balances, LP positions (see **Required agent reply for holdings** under `query.js`), quotes, and arbitrary ERC20 token info
- Buy or sell ATX against USDT on PancakeSwap V3
- Add liquidity (full range or a custom **price range in USDT per ATX** or **tick** bounds), remove liquidity, collect fees, or burn empty LP NFTs
- Transfer BNB, ATX, USDT, or arbitrary ERC20 tokens

## Before First Use

This skill ships its own Node scripts and depends on `atxswap-sdk`.

1. Open the skill directory where this `SKILL.md` is installed.
2. Run `npm install` there before using any script.
3. If `npm install` fails, stop and report the dependency error instead of guessing.

If the skill is installed via ClawHub or OpenClaw CLI, the install location is
typically `~/.clawhub/skills/atxswap/` (or the equivalent client-managed path).
If you cloned this repository directly, the location is `skills/atxswap/`.

## Script Location

Use the skill directory path to locate scripts. If `${SKILL_DIR}` is available
(injected by skills.sh-compatible runtimes), use it; otherwise use the absolute
path to this skill's installed directory.

Example:

```bash
cd skills/atxswap && npm install
cd "${SKILL_DIR}" && node scripts/wallet.js list
```

All examples below use `cd "${SKILL_DIR}" &&` for clarity. If your runtime does
not inject `${SKILL_DIR}`, replace it with the absolute path of the installed
skill directory.

## Runtime Notes

-

README.md

# ATXSwap Skill

A skill bundle for the ATXSwap decentralized agent exchange protocol on BSC. A single `SKILL.md`
works across clients represented by **Claude Code** and **OpenClaw**, so you do
not need separate directories for different clients.

[**中文文档**](./README.zh.md)

- **GitHub**: https://github.com/agentswapx/skills
- **SDK on npm**: [`atxswap-sdk`](https://www.npmjs.com/package/atxswap-sdk)
- **SDK source / docs**: [agentswapx/atxswap-sdk](https://github.com/agentswapx/atxswap-sdk)

For project background and a short [team introduction](https://docs.atxswap.com/guide/team) ([中文](https://docs.atxswap.com/zh/guide/team)), see the ATXSwap documentation site. This README describes the skill’s scope and scripts.

## What This Skill Covers

- Create the single wallet used by the skill (importing an existing private key is not supported)
- Query ATX price, balances, LP positions, and ERC20 token info
- Buy or sell ATX against USDT on PancakeSwap V3
- Preview custom-range liquidity, add liquidity, remove liquidity, collect fees, and burn empty LP NFTs
- Transfer BNB, ATX, USDT, or arbitrary ERC20 tokens

## Directory Layout

```text
atxswap/
├── SKILL.md
├── README.md
├── README.zh.md
├── PUBLISH.md
├── CHANGELOG.md
├── .clawhubignore
├── .gitignore
├── package.json
└── scripts/
    ├── _helpers.js
    ├── wallet.js
    ├── query.js
    ├── swap.js
    ├── liquidity.js
    └── transfer.js
```

## Install

### OpenClaw Install

```bash
openclaw skills install atxswap
```

### Claude Code Install

```bash
git clone https://github.com/agentswapx/skills.git
cd skills/atxswap && npm install
```

By default the skill uses a built-in fallback list of 6 BSC public RPC
endpoints. To override, set `BSC_RPC_URL` to a single URL or to a
comma-separated list (priority left to right):

```bash
export BSC_RPC_URL="https://my-private-rpc.example.com,https://bsc-dataseed.bnbchain.org"
```

## Common Commands

```bash
cd skills/atxswap && node scripts/wallet.js list
cd skills/atxswap && node scripts/query.js price
cd skills/atxswap && node scripts/query.js quote buy 1
cd skills/atxswap && node scripts/query.js positions <address> <tokenId>
cd skills/atxswap && node scripts/liquidity.js quote-add usdt 0.1 --range-percent 20
```

When invoked through a `${SKILL_DIR}`-aware runtime, `cd "${SKILL_DIR}"` is
preferred so the skill works regardless of where the client installed it.

## Liquidity Preview

For custom-range liquidity, do not guess the second token amount from chat.
Preview first, then write:

```bash
cd "${SKILL_DIR}" && node scripts/liquidity.js quote-add usdt 0.1 --range-percent 20
cd "${SKILL_DIR}" && node scripts/liquidity.js add --base-token usdt --amount 0.1 --range-percent 20 --from <address>
```

Supported custom range modes:

- `--range-percent <n>`: expands around the current ATX price, e.g. `20` means `-20% ~ +20%`
- `--min-price <p> --max-price <p>`: explicit `USDT per 1 ATX`
- `--tick-lower <n> --tick-upper <n>`: raw V3 ticks

Recommended flo

_meta.json

{
  "ownerId": "kn7b4v7fs97tk2t9cd0z2zef0s84e311",
  "slug": "atxswap",
  "version": "0.0.31",
  "publishedAt": 1778770957784
}

CHANGELOG.md

# Changelog

## 0.0.31

- ClawHub republish; registry tarball unchanged (`atxswap-sdk` **`^0.0.15`**). `SKILL.md` / `README*` — require fresh on-chain reads for balances/positions; transfer intent recap, no duplicate sends after `txHash`, no blind retries on ambiguous RPC/signing.; `frontend`/`docs-site` `llms.txt` reference **`0.0.31`**.

## 0.0.30

- ClawHub republish; registry tarball unchanged (`atxswap-sdk` **`^0.0.15`**). Docs: `llms.txt` updated to reference latest **`0.0.30`**.

## 0.0.29

- ClawHub publish: registry tarball bundles `atxswap-sdk` **`^0.0.15`** (npm **`0.0.15`**).
- `query.js positions`: emits **`priceRangeUsdtPerAtx`**, **`currentPriceUsdtPerAtx`**, **`currentPriceInRange`**, **`pendingFees`** `{ atx, usdt }`; **`tickLower`/`tickUpper`** removed from printed JSON. `SKILL.md` / `README*` updated.

## 0.0.28

- ClawHub publish: registry tarball bundles `atxswap-sdk` **`^0.0.15`** (npm **`0.0.15`**).
- `query.js positions`: add **`feePercent`** (human-readable pool swap fee, e.g. `"0.25%"`; raw **`fee`** remains the on-chain tier code such as `2500`). `SKILL.md` instructs agents to prefer **`feePercent`** in user-facing summaries.

## 0.0.27

- ClawHub publish: registry tarball bundles `atxswap-sdk` **`^0.0.15`** (npm **`0.0.15`**); includes **`principalAtx`/`principalUsdt`** in `query.js positions`, `_v3math.js`, and updated `SKILL.md`/`README*` for LP-vs-wallet semantics.

## 0.0.26

- `query.js positions` outputs **`principalAtx`**, **`principalUsdt`**, `principal0`/`principal1`: in-range token amounts computed from `liquidity` + ticks + spot `sqrtPriceX96` (`getAmountsForLiquidity`), using SDK-provided `principal*` when present (future `atxswap-sdk` versions) to avoid an extra `getPrice()` call. `SKILL.md` updated: distinguish LP principal from **`query.js balance`** (wallet); warns agents not to substitute wallet balances for position tokens; table row fully English. `README.md` / `README.zh.md` fee section documents `principal*` vs `collectable*`.

## 0.0.25

- ClawHub publish: registry tarball bundles `atxswap-sdk` `^0.0.14` (npm 0.0.14). `SKILL.md` is English-only; documents required agent reply for LP holdings (tokens, NFT id, price range, pending fees); `liquidity.js` narrative translated to English.

## 0.0.24

- ClawHub publish: registry tarball bundles `atxswap-sdk` `^0.0.14` (npm 0.0.14); skill scripts use shared `jsonStringify` for BigInt-safe JSON output.

## 0.0.23

- ClawHub publish: registry tarball bundles `atxswap-sdk` `^0.0.14` (npm 0.0.14); `SKILL.md` hard-safety keystore channel wording (English).

## 0.0.22

- ClawHub publish: registry tarball bundles `atxswap-sdk` `^0.0.14` (npm 0.0.14).

## 0.0.21

- ClawHub publish: registry tarball bundles `atxswap-sdk` `^0.0.14` (npm 0.0.14).

## 0.0.20

- ClawHub publish: registry tarball bundles `atxswap-sdk` `^0.0.14` (npm 0.0.14).

## 0.0.19

- ClawHub publish: registry tarball bundles `atxswap-sdk` `^0.0.14` (npm 0.0.14).

## 0.0.18

- ClawHub publish: regi

PUBLISH.md

# Publish Notes

This directory is published to **ClawHub** as a single skill bundle that also
works as a standalone `skills.sh`-compatible package (Claude / Cursor / Codex
CLI). The same `SKILL.md` frontmatter declares both conventions, so a single
source of truth covers all clients. After publish, the skill is installable via
both `clawhub install atxswap` and `openclaw skills install atxswap` (OpenClaw
pulls from the same ClawHub registry).

> Heads up: the OpenClaw CLI itself does **not** have `skills publish` or
> `skills validate` subcommands. All publishing flows through the dedicated
> `clawhub` CLI (`npm install -g clawhub`).

## Pre-publish checklist

1. Bump versions consistently:
   - `SKILL.md` frontmatter `version`
   - `package.json` `version`
   - These two MUST match — `clawhub publish --version` overrides them at
     upload time but mismatched local values confuse `skills.sh` consumers.
2. Install dependencies inside this directory (`npm install`) so the SDK
   builds cleanly.
3. Run the local read-only checks:
   - `node scripts/wallet.js list`
   - `node scripts/query.js price`
   - `node scripts/query.js quote buy 1`
4. Confirm the folder does not include secrets, keystore files, or
   `node_modules/`. (`.clawhubignore` already excludes `node_modules/`,
   `.clawhub/`, `.clawdhub/`, `.DS_Store`, `*.log`.)
5. Make sure the parent submodule (`agentswapx/skills`) is committed and
   pushed — the published `homepage` URL points at GitHub.

## Authenticate with ClawHub

```bash
# Browser flow (opens a token-grant page)
clawhub login

# Or token flow (no browser)
clawhub login --token <YOUR_TOKEN> --no-browser

# Verify
clawhub whoami
```

## Publish

```bash
clawhub publish ./skills/atxswap \
  --slug atxswap \
  --name "ATXSwap" \
  --version 0.0.1 \
  --tags latest,atxswap,atx,bsc,trading
```

After upload there is a brief security-scan window during which `clawhub
inspect atxswap` returns "Skill is hidden while security scan is pending".

Once the scan completes, ClawHub will flag this skill as "suspicious" because
VirusTotal Code Insight detects crypto-key / external-API patterns — that is
expected for any wallet SDK and not a real warning. Users must pass `--force`
in non-interactive contexts:

```bash
clawhub install atxswap --force
```

## Verify the published skill

```bash
# Registry round-trip
clawhub inspect atxswap

# End-user simulation in a clean directory
TEST=$(mktemp -d)
cd "$TEST" && clawhub install atxswap --force
cd skills/atxswap && npm install   # pulls atxswap-sdk from npm (~15s)
node scripts/query.js              # should print usage
```

## Suggested changelog

```text
Initial ClawHub release for ATX wallet, query, swap, liquidity, and transfer
workflows on BSC. Compatible with both ClawHub/OpenClaw clients and the
standalone skills.sh runtime.
```

Github ReposUpdated 20h agoRank 70

AionUi

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!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

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

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.