clipx-bnbchain-api-client

## Response rules (read first)

**Rule 1 — Menu format:** Always use numbered lines (1. 2. 3. …). See "Interactive menu" section.

**Rule 2 — Table format:** Always wrap the table output inside a markdown code block (triple backticks). Start with a line containing only three backticks, then the table lines, then a line containing only three backticks. This is required so the table displays in monospace with aligned columns. The API returns tables formatted at **40 chars per line** (mobile-friendly); do not reformat or truncate — pass through exactly. **Exception:** For option 11 (Binance Announcements), do NOT wrap in code block — pass through the API output as-is (plain markdown with **📢 Binance Announcements** header, 🔸 bullets, and blank line after each item).

**Rule 3 — Response ends with the output.** After the table (or Binance list for option 11), your message is complete. Write nothing else.

---

## What this skill does

Calls the ClipX BNBChain API via `python "{baseDir}/api_client_cli.py"` to fetch text-only BNB Chain metrics and rankings. The backend handles all scraping.

---

## Interactive menu

When the user says "clipx", "bnbchain", "bnbchain analysis", or asks for BNB Chain reports without specifying which one, output this menu exactly:

Output this menu inside a code block (triple backticks) so it displays as a formatted box:

```
========================================
🟡 ClipX / BNBChain Analysis
========================================
 1. TVL Rank
 2. Fees Rank (24h/7d/30d)
 3. Revenue Rank (24h/7d/30d)
 4. DApps Rank
 5. Full Ecosystem
 6. Social Hype
 7. Meme Rank
 8. Network Metrics
 9. Market Insight
10. Market Insight (Live)
11. Binance Announcements
12. DEX Volume (24h/7d/30d)
========================================
Reply with a number (1–12)
```

---

## Commands (number → command)

| # | Command |
|---|---------|
| 1 | `python "{baseDir}/api_client_cli.py" --mode clipx --analysis-type tvl_rank --timezone UTC` |
| 2 | `python "{bas...

# ClipX Skills

> BNB Chain analytics for OpenClaw — TVL, fees, revenue, DApps, market insight, and more. Thin client, no API keys, no scraping on the client.

[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![OpenClaw](https://img.shields.io/badge/OpenClaw-Skill-green.svg)](https://openclaw.ai)
[![BNB Chain](https://img.shields.io/badge/BNB%20Chain-BSC-yellow.svg)](https://bnbchain.org)

---

## Table of Contents

- [Overview](#overview)
- [Architecture](#architecture)
- [Menu Options](#menu-options)
- [Quick Start](#quick-start)
- [File Structure](#file-structure)
- [API Reference](#api-reference)
- [Local Testing](#local-testing)
- [Configuration](#configuration)
- [Server-Side API](#server-side-api)
- [Publishing](#publishing)
- [Troubleshooting](#troubleshooting)

---

## Overview

**ClipX Skills** is a thin HTTP client for the ClipX BNBChain API. It lets OpenClaw agents fetch BNB Smart Chain metrics and rankings via a simple CLI. All scraping, Playwright, and heavy logic run on the private API — this skill only calls HTTP endpoints.

| Category | Capabilities |
|----------|--------------|
| **Rankings** | TVL, fees, revenue, DApps, full ecosystem, social hype, meme rank |
| **Market** | Volume leaders, gainers/losers, Binance announcements |
| **Network** | Block, gas, sync state, block stats, address balance |
| **Output** | Text-only JSON, pre-formatted tables, monospace code blocks |

**Design:** Thin client · Text-only · Zero secrets (no API keys required)

---

## Architecture

```
User → OpenClaw Agent → api_client_cli.py → ClipX API (VPS) → DefiLlama / DappBay / Binance
                                                                    ↓
User ← OpenClaw Agent ← formatted table / JSON ← api_client_cli.py ←
```

Flow: User says "clipx" or "bnbchain" → Agent shows menu → User replies with number → Agent runs CLI → CLI calls API → API returns formatte...