@four-meme/four-meme-ai 1.0.7 → 1.0.8

package/CLAUDE.md

@@ -1,91 +1,91 @@
-# four-meme-ai – Agent Guidelines (Claude / Claude Code)
-
-## Overview
-
-This repo provides the **four-meme-integration** skill for AI agents: create and trade meme tokens on **four.meme (BSC only)** using the official API and on-chain contracts (**TokenManager2**, **TokenManagerHelper3**). TokenManager V1 is **not** supported by this skill.
-
-The authoritative specification for this skill is `skills/four-meme-integration/SKILL.md`. Claude/Claude Code should treat that file as the main contract for behavior, safety, and command usage.
-
-## When to Use This Skill
-
-Use this repo when the user explicitly or implicitly asks to:
-
-- **Create** a meme token on four.meme on BSC (full API flow + `TokenManager2.createToken` on-chain).
-- **Buy** or **sell** a four.meme token on BSC (quote with Helper3, execute via TokenManager2).
-- **Query token info** (version, tokenManager, price, offers, etc.) for a given token address or requestId.
-- **Query lists / rankings** of four.meme tokens (REST list, detail, advanced rankings).
-- **Query Tax token fee/tax config**, or execute Tax-type token creation.
-- **Send BNB / ERC20** from the trading wallet to another address on BSC.
-- **Register / query** an EIP‑8004 identity NFT (8004 registry contract on BSC).
-
-If the user’s request does not involve four.meme, BSC, or these flows, you should not use this skill.
-
-## Repo Layout
-
-```
-four-meme-ai/
-├── skills/
-│   └── four-meme-integration/
-│       ├── SKILL.md        # Main skill instructions (Cursor / OpenClaw)
-│       ├── references/     # API, addresses, errors, trading, events, tax
-│       └── scripts/        # create-token, get-token-info, quote-buy/sell, etc.
-├── bin/
-│   └── fourmeme.cjs        # CLI dispatcher (fourmeme ...)
-├── package.json
-├── README.md
-└── CLAUDE.md               # This file (Claude-facing guidelines)
-```
-
-## Safety and Private Key Handling
-
-The SKILL defines a **User Agreement & Security Notice** (bilingual: English + Traditional Chinese). Claude MUST:
-
-1. On first use of this skill in a conversation, present the User Agreement and Security Notice in the user’s language (use the 繁體中文 block when the user writes in Traditional Chinese; otherwise use English).
-2. Make clear that **continuing to use this plugin/skill implies acceptance of the User Agreement**.
-3. **MUST NOT** run any operation that uses a private key or writes on-chain (e.g. `create-api`, `create-chain`, `buy`, `sell`, `send`, `8004-register`) until the user has explicitly agreed or confirmed to continue.
-4. May run read‑only commands (e.g. `config`, `token-info`, `quote-buy`, `8004-balance`) while or after presenting the notice.
-
-Never ask the user to paste a private key into chat. All private keys must come from environment / config (e.g. `PRIVATE_KEY`) as described in `SKILL.md`.
-
-## Conventions (aligned with SKILL.md)
-
-1. **Chain**: BSC only (chainId 56). Arbitrum and Base are **out of scope** for this skill.
-2. **Trading**:
-   - Always call Helper3 `getTokenInfo(token)` first to get `version`, `tokenManager`, and current price/offers.
-   - Only **version 2** (TokenManager2) is supported by this skill; do not attempt V1 flows.
-   - For X Mode / TaxToken / AntiSniperFeeMode detection and error codes, see `skills/four-meme-integration/references/errors.md`.
-3. **Create token**:
-   - `raisedToken` must always come from `GET https://four.meme/meme-api/v1/public/config` and be used **as is** in the create body; do not invent or modify internal fields.
-   - For tax-type tokens, follow `tokenTaxInfo` constraints in `references/token-tax-info.md` and the interactive flow in `SKILL.md` (“Create token (full flow)”).
-4. **RPC and private key (environment)**:
-   - When **using OpenClaw**: PRIVATE_KEY and BSC_RPC_URL are configured in OpenClaw (e.g. `skills.entries["four-meme-ai"].env` or apiKey); see SKILL.md.
-   - When **not using OpenClaw (standalone)**: set `PRIVATE_KEY` and optionally `BSC_RPC_URL` via the process environment—e.g. a `.env` file in the **directory where you run `fourmeme`** (the CLI loads it automatically via dotenv) or shell `export`. Do not ask the user to paste a private key in chat.
-
-## CLI Usage (fourmeme)
-
-From the project root after `npm install`, use:
-
-```bash
-npx fourmeme <command> [args...]
-```
-
-Key commands (full list and parameters in `SKILL.md`):
-
-- `fourmeme config` – Get public config (raisedToken).
-- `fourmeme create-api` / `fourmeme create-chain` – Create token (API + on-chain).
-- `fourmeme token-info` / `token-list` / `token-get` / `token-rankings` – On-chain info and REST queries.
-- `fourmeme quote-buy` / `quote-sell` – Estimate buy/sell without sending tx.
-- `fourmeme buy` / `sell` – Execute buy/sell via TokenManager2 (V2 only).
-- `fourmeme send` – Send BNB or ERC20 from the trading wallet.
-- `fourmeme 8004-register` / `8004-balance` – EIP‑8004 identity NFT register and query.
-- `fourmeme events` – TokenManager2 events (TokenCreate, TokenPurchase, TokenSale, LiquidityAdded).
-- `fourmeme tax-info` – TaxToken on-chain fee/tax config.
-
-Always prefer these CLI commands rather than calling scripts directly, unless `SKILL.md` suggests otherwise.
-
-## External Docs
-
-For deeper protocol details, see:
-
-- In-repo: `skills/four-meme-integration/references/` (api-create-token, token-query-api, execute-trade, event-listening, tax-token-query, errors).
-- Official four.meme API and contracts (online): [Protocol Integration](https://four-meme.gitbook.io/four.meme/brand/protocol-integration) (API documents, ABIs: TokenManager, TokenManager2, Helper3, TaxToken, etc.).
+# four-meme-ai – Agent Guidelines (Claude / Claude Code)
+
+## Overview
+
+This repo provides the **four-meme-integration** skill for AI agents: create and trade meme tokens on **four.meme (BSC only)** using the official API and on-chain contracts (**TokenManager2**, **TokenManagerHelper3**). TokenManager V1 is **not** supported by this skill.
+
+The authoritative specification for this skill is `skills/four-meme-integration/SKILL.md`. Claude/Claude Code should treat that file as the main contract for behavior, safety, and command usage.
+
+## When to Use This Skill
+
+Use this repo when the user explicitly or implicitly asks to:
+
+- **Create** a meme token on four.meme on BSC (full API flow + `TokenManager2.createToken` on-chain).
+- **Buy** or **sell** a four.meme token on BSC (quote with Helper3, execute via TokenManager2).
+- **Query token info** (version, tokenManager, price, offers, etc.) for a given token address or requestId.
+- **Query lists / rankings** of four.meme tokens (REST list, detail, advanced rankings).
+- **Query Tax token fee/tax config**, or execute Tax-type token creation.
+- **Send BNB / ERC20** from the trading wallet to another address on BSC.
+- **Register / query** an EIP‑8004 identity NFT (8004 registry contract on BSC).
+
+If the user’s request does not involve four.meme, BSC, or these flows, you should not use this skill.
+
+## Repo Layout
+
+```
+four-meme-ai/
+├── skills/
+│   └── four-meme-integration/
+│       ├── SKILL.md        # Main skill instructions (Cursor / OpenClaw)
+│       ├── references/     # API, addresses, errors, trading, events, tax
+│       └── scripts/        # create-token, get-token-info, quote-buy/sell, etc.
+├── bin/
+│   └── fourmeme.cjs        # CLI dispatcher (fourmeme ...)
+├── package.json
+├── README.md
+└── CLAUDE.md               # This file (Claude-facing guidelines)
+```
+
+## Safety and Private Key Handling
+
+The SKILL defines a **User Agreement & Security Notice** (bilingual: English + Traditional Chinese). Claude MUST:
+
+1. On first use of this skill in a conversation, present the User Agreement and Security Notice in the user’s language (use the 繁體中文 block when the user writes in Traditional Chinese; otherwise use English).
+2. Make clear that **continuing to use this plugin/skill implies acceptance of the User Agreement**.
+3. **MUST NOT** run any operation that uses a private key or writes on-chain (e.g. `create-api`, `create-chain`, `buy`, `sell`, `send`, `8004-register`) until the user has explicitly agreed or confirmed to continue.
+4. May run read‑only commands (e.g. `config`, `token-info`, `quote-buy`, `8004-balance`) while or after presenting the notice.
+
+Never ask the user to paste a private key into chat. All private keys must come from environment / config (e.g. `PRIVATE_KEY`) as described in `SKILL.md`.
+
+## Conventions (aligned with SKILL.md)
+
+1. **Chain**: BSC only (chainId 56). Arbitrum and Base are **out of scope** for this skill.
+2. **Trading**:
+   - Always call Helper3 `getTokenInfo(token)` first to get `version`, `tokenManager`, and current price/offers.
+   - Only **version 2** (TokenManager2) is supported by this skill; do not attempt V1 flows.
+   - For X Mode / TaxToken / AntiSniperFeeMode detection and error codes, see `skills/four-meme-integration/references/errors.md`.
+3. **Create token**:
+   - `raisedToken` must always come from `GET https://four.meme/meme-api/v1/public/config` and be used **as is** in the create body; do not invent or modify internal fields.
+   - For tax-type tokens, follow `tokenTaxInfo` constraints in `references/token-tax-info.md` and the interactive flow in `SKILL.md` (“Create token (full flow)”).
+4. **RPC and private key (environment)**:
+   - When **using OpenClaw**: PRIVATE_KEY and BSC_RPC_URL are configured in OpenClaw (e.g. `skills.entries["four-meme-ai"].env` or apiKey); see SKILL.md.
+   - When **not using OpenClaw (standalone)**: set `PRIVATE_KEY` and optionally `BSC_RPC_URL` via the process environment—e.g. a `.env` file in the **directory where you run `fourmeme`** (the CLI loads it automatically via dotenv) or shell `export`. Do not ask the user to paste a private key in chat.
+
+## CLI Usage (fourmeme)
+
+From the project root after `npm install`, use:
+
+```bash
+npx fourmeme <command> [args...]
+```
+
+Key commands (full list and parameters in `SKILL.md`):
+
+- `fourmeme config` – Get public config (raisedToken).
+- `fourmeme create-api` / `fourmeme create-chain` – Create token (API + on-chain).
+- `fourmeme token-info` / `token-list` / `token-get` / `token-rankings` – On-chain info and REST queries.
+- `fourmeme quote-buy` / `quote-sell` – Estimate buy/sell without sending tx.
+- `fourmeme buy` / `sell` – Execute buy/sell via TokenManager2 (V2 only).
+- `fourmeme send` – Send BNB or ERC20 from the trading wallet.
+- `fourmeme 8004-register` / `8004-balance` – EIP‑8004 identity NFT register and query.
+- `fourmeme events` – TokenManager2 events (TokenCreate, TokenPurchase, TokenSale, LiquidityAdded).
+- `fourmeme tax-info` – TaxToken on-chain fee/tax config.
+
+Always prefer these CLI commands rather than calling scripts directly, unless `SKILL.md` suggests otherwise.
+
+## External Docs
+
+For deeper protocol details, see:
+
+- In-repo: `skills/four-meme-integration/references/` (api-create-token, token-query-api, execute-trade, event-listening, tax-token-query, errors).
+- Official four.meme API and contracts (online): [Protocol Integration](https://four-meme.gitbook.io/four.meme/brand/protocol-integration) (API documents, ABIs: TokenManager, TokenManager2, Helper3, TaxToken, etc.).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lol-dev-99
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -31,9 +31,9 @@ When the user needs to create or trade meme tokens on four.meme (BSC), use the *
 | `create-chain` | `<createArgHex>` `<signatureHex>` `[--value=<wei>]` or `--` (stdin JSON) | Submit createToken on BSC. Env: PRIVATE_KEY. |
 | `create-instant` | `--image=` `--name=` `--short-name=` `--desc=` `--label=` `[--web-url=]` `[--twitter-url=]` `[--telegram-url=]` `[--pre-sale=<BNB>]` `[--fee-plan=false]` `[--value=<wei>]` `[--tax-options=<path>]` or `[--tax-token --tax-fee-rate=5 ...]` | One-shot create (API + chain). Same options as create-api plus `--value=` override. Env: PRIVATE_KEY. |
 | `token-info` | `<tokenAddress>` | On-chain token info (Helper3). |
-| `token-list` | `[--orderBy=Hot]` `[--pageIndex=1]` `[--pageSize=30]` `[--tokenName=]` `[--symbol=]` `[--labels=]` `[--listedPancake=false]` | REST token list. |
+| `token-list` | Legacy query flags or `[--type=]` `[--listType=]` `[--keyword=]` `[--tag=]` `[--status=]` `[--sort=]` `[--version=]` … (also legacy `--queryMode=Binance|USD1` to infer `listType`) | POST `/public/token/search` (token list). |
 | `token-get` | `<tokenAddress>` | REST token detail + trading info. |
-| `token-rankings` | `<orderBy>` `[--barType=HOUR24]` | Rankings. orderBy: `Time|ProgressDesc|TradingDesc|Hot|Graduated`. |
+| `token-rankings` | `<orderBy or type>` `[--barType=]` `[--pageSize=]` `[--symbol=]` `[--version=]` `[--rankingKind=]` `[--minCap=]` `[--maxCap=]` `[--minVol=]` `[--maxVol=]` `[--minHold=]` `[--maxHold=]` … | POST `/public/token/ranking`; legacy orderBy or native type (e.g. `VOL_DAY_1`). |
 | `quote-buy` | `<tokenAddress>` `<amountWei>` `[fundsWei]` | Estimate buy (no tx). Use 0 for amount or funds. |
 | `quote-sell` | `<tokenAddress>` `<amountWei>` | Estimate sell (no tx). |
 | `buy` | `<token>` `amount` `<amountWei>` `<maxFundsWei>` | Buy fixed amount. Env: PRIVATE_KEY. |

package/bin/fourmeme.cjs

@@ -87,14 +87,17 @@ Commands and parameters:
     On-chain token info (Helper3). No auth.
 
   token-list
-    [--orderBy=Hot] [--pageIndex=1] [--pageSize=30] [--tokenName=] [--symbol=] [--labels=] [--listedPancake=false]
-    REST token list. No auth.
+    POST /public/token/search. Legacy: [--orderBy=] [--tokenName=] [--listedPancake=] …
+    New: [--type=] [--listType=] [--keyword=] [--tag=] [--status=] [--sort=] [--version=] [--pageIndex=] [--pageSize=].
+         Legacy queryMode mapping: [--queryMode=Binance|USD1] (infers listType BIN/BIN_DEX or USD1/USD1_DEX by listedPancake).
+    No auth.
 
   token-get <tokenAddress>
     REST token detail + trading info. No auth.
 
-  token-rankings <orderBy> [--barType=HOUR24]
-    orderBy: Time|ProgressDesc|TradingDesc|Hot|Graduated. barType for TradingDesc. No auth.
+  token-rankings <orderBy|type> [--barType=HOUR24] [--pageSize=] [--symbol=] [--version=] [--rankingKind=] [--minCap=] [--maxCap=] [--minVol=] [--maxVol=] [--minHold=] [--maxHold=] …
+    POST /public/token/ranking. Legacy: Time|ProgressDesc|TradingDesc|Hot|Graduated; or native type e.g. VOL_DAY_1.
+    No auth.
 
   quote-buy <tokenAddress> <amountWei> [fundsWei]
     Estimate buy. Use 0 for amount or funds. No tx.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@four-meme/four-meme-ai",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Four.meme AI skills for creating and trading meme tokens (BSC only)",
   "license": "MIT",
   "type": "module",

package/skills/four-meme-integration/SKILL.md

@@ -120,9 +120,9 @@ Set **PRIVATE_KEY** and optionally **BSC_RPC_URL** via the process environment s
 |------|---------|------|
 | Public config | `fourmeme config` | Get raisedToken / config (no auth) |
 | Token info (on-chain) | `fourmeme token-info <tokenAddress>` | Version, tokenManager, price, offers (BSC Helper3) |
-| Token list (REST) | `fourmeme token-list [--orderBy=] [--pageIndex=] [--pageSize=] [--tokenName=] [--symbol=] [--labels=] [--listedPancake=]` | Filtered, paginated token list |
+| Token list (REST) | `fourmeme token-list` — POST `/public/token/search`; legacy flags `[--orderBy=] …` plus legacy `--queryMode=Binance|USD1` (infers `listType`), or new `[--type=] [--listType=] [--keyword=] [--tag=] [--status=] [--sort=] [--version=]` | Filtered, paginated token list |
 | Token detail (REST) | `fourmeme token-get <tokenAddress>` | Token detail and trading info (get/v2) |
-| Token rankings (REST) | `fourmeme token-rankings <orderBy> [--barType=HOUR24]` | Time / ProgressDesc / TradingDesc / Hot / Graduated; barType for TradingDesc |
+| Token rankings (REST) | `fourmeme token-rankings <orderBy|type> [--barType=…]` | POST `/public/token/ranking`; legacy orderBy or native RankingType (e.g. VOL_DAY_1); optional filters `--pageSize` `--symbol` `--version` `--rankingKind` `minCap` `maxCap` `minVol` `maxVol` `minHold` `maxHold` … |
 | Buy quote | `fourmeme quote-buy <token> <amountWei> [fundsWei]` | Estimate only; no transaction |
 | Sell quote | `fourmeme quote-sell <token> <amountWei>` | Estimate only; no transaction |
 | **Execute buy** | `fourmeme buy <token> amount <amountWei> <maxFundsWei>` | Buy fixed amount (needs PRIVATE_KEY) |
@@ -210,10 +210,13 @@ On-chain query (Helper3); returns version, tokenManager, price, offers, etc.
 
 Four.meme REST API; use `Accept: application/json`; no login or cookie.
 
-**Token list (filter / paginate)**  
+**Token list (filter / paginate)** — `POST /public/token/search`  
 ```bash
 fourmeme token-list [--orderBy=Hot] [--pageIndex=1] [--pageSize=30] [--tokenName=] [--symbol=] [--labels=] [--listedPancake=false]
+fourmeme token-list [--type=HOT] [--listType=NOR] [--keyword=] [--tag=Meme,AI] [--status=PUBLISH|TRADE|ALL] [--sort=DESC] [--version=]
+fourmeme token-list [--queryMode=Binance|USD1] [--listedPancake=true|false]  (legacy shortcut; infers listType BIN/BIN_DEX or USD1/USD1_DEX)
 ```
+Legacy `listedPancake=false` maps to `status=PUBLISH`; use `--status=ALL` when you need all statuses.
 
 **Token detail and trading info**  
 ```bash
@@ -221,11 +224,11 @@ fourmeme token-get <tokenAddress>
 ```
 API: GET `/private/token/get/v2?address=...`
 
-**Rankings**  
+**Rankings** — `POST /public/token/ranking`  
 ```bash
-fourmeme token-rankings <orderBy> [--barType=HOUR24]
+fourmeme token-rankings <orderBy|type> [--barType=HOUR24] [--pageSize=20] [--symbol=] [--version=] [--rankingKind=] [--minCap=] [--maxCap=] [--minVol=] [--maxVol=] [--minHold=] [--maxHold=] …
 ```
-orderBy: `Time` (newest) | `ProgressDesc` | `TradingDesc` (24h volume; barType HOUR24) | `Hot` | `Graduated`. Output JSON.
+Legacy orderBy: `Time` → NEW | `ProgressDesc` | `TradingDesc` (volume window via `--barType`: HOUR24→VOL_DAY_1, HOUR4, HOUR1, MIN30, MIN5) | `Hot` | `Graduated` → DEX. Or pass API `type` directly (e.g. `VOL_DAY_1`, `CAP`, `BURN`). Output JSON.
 
 ### quote-buy / quote-sell (estimate only; no transaction)
 
@@ -328,8 +331,8 @@ See [references/tax-token-query.md](references/tax-token-query.md).
 This skill supports a flow to discover tokens, get details, quote, and execute. The following is an example workflow, not a trading recommendation: discover → detail → quote → execute.
 
 1. **Discover** (one or more of):  
-   - **Rankings**: `fourmeme token-rankings <orderBy>` (orderBy = Hot, TradingDesc, Time, ProgressDesc, Graduated); use token addresses from the response.  
-   - **List**: `fourmeme token-list [--orderBy=] [--labels=] ...` to filter and get addresses.  
+   - **Rankings**: `fourmeme token-rankings <orderBy or type>` (legacy: Hot, TradingDesc, Time, ProgressDesc, Graduated; or e.g. VOL_DAY_1); use token addresses from the response.  
+   - **List**: `fourmeme token-list` (`/public/token/search`) with `--orderBy` / `--type`, `--labels` / `--tag`, etc., to filter and get addresses.  
    - **On-chain events**: `fourmeme events <fromBlock> [toBlock]`; parse token addresses from TokenCreate/TokenPurchase, etc., for "newly created" or "recent trades" strategies.
 2. **Get details**: For each candidate, call `fourmeme token-get <address>` (REST detail and trading info) or `fourmeme token-info <address>` (on-chain version, tokenManager, price, offers) to filter or display.
 3. **Quote**: `fourmeme quote-buy <token> <amountWei> [fundsWei]` / `fourmeme quote-sell <token> <amountWei>` for estimated cost or proceeds.

package/skills/four-meme-integration/references/token-query-api.md

@@ -4,19 +4,21 @@ Base: `https://four.meme/meme-api/v1`. Requests need `Accept: application/json`;
 
 ## 1. Token list (filter / paginate)
 
-**GET** `/private/token/query`
-
-| Parameter | Description | Example |
-|-----------|-------------|---------|
-| orderBy | Sort order | Hot, Time, ... |
-| tokenName | Filter by token name | Empty or name |
-| symbol | Filter by symbol | Empty or symbol |
-| labels | Filter by label | Empty or label |
-| listedPancake | Listed on Pancake | false / true |
-| pageIndex | Page number | 1 |
-| pageSize | Page size | 30 |
-
-CLI: `fourmeme token-list [--orderBy=Hot] [--pageIndex=1] [--pageSize=30] [--tokenName=] [--symbol=] [--labels=] [--listedPancake=false]`
+**POST** `/public/token/search`  
+JSON body: `type`, `listType`, `pageIndex`, `pageSize`, `status`, `sort`, optional `keyword`, `symbol`, `tag` (array), `version`.
+
+| Parameter | Description |
+|-----------|-------------|
+| type | Ranking sort context: NEW, HOT, PROGRESS, VOL, LAST, CAP, DEX, BURN, … |
+| listType | NOR, NOR_DEX, BIN, USD1, BIN_DEX, USD1_DEX, ADV |
+| status | PUBLISH, TRADE, ALL |
+| sort | DESC, ASC |
+| keyword | Search keyword |
+| symbol | Quote symbol (e.g. BNB, USDT) |
+| tag | Label filters (e.g. Meme, AI) |
+| version | V9 (tax), V10 (AI); omit for all |
+
+CLI: `fourmeme token-list` — legacy flags still map to the above (e.g. `--orderBy` → `type`, `--tokenName` → `keyword`, `--labels` → `tag`, `--listedPancake=false` → `status=PUBLISH`). See script header for full list.
 
 ## 2. Token detail and trading info
 
@@ -24,17 +26,19 @@ CLI: `fourmeme token-list [--orderBy=Hot] [--pageIndex=1] [--pageSize=30] [--tok
 
 CLI: `fourmeme token-get <tokenAddress>`
 
-## 3. Rankings (advanced)
+## 3. Rankings
+
+**POST** `/public/token/ranking`  
+JSON body: `type` (required RankingType), `pageSize`, optional `rankingKind`, `version`, `symbol`, `minCap`, `maxCap`, `minVol`, `maxVol`, `minHold`, `maxHold`.
 
-**POST** `/private/token/query/advanced`  
-Body (JSON): `{ "orderBy": "<value>" }` or `{ "orderBy": "TradingDesc", "barType": "HOUR24" }`
+| Legacy CLI orderBy | Maps to type |
+|--------------------|--------------|
+| Time | NEW |
+| ProgressDesc | PROGRESS |
+| TradingDesc | VOL_DAY_1 (default); `--barType` selects VOL_HOUR_1, VOL_HOUR_4, VOL_MIN_30, VOL_MIN_5, … |
+| Hot | HOT |
+| Graduated | DEX |
 
-| orderBy | Description |
-|---------|-------------|
-| Time | Newest tokens |
-| ProgressDesc | Fundraise progress ranking |
-| TradingDesc | 24h trading volume (can use barType: HOUR24) |
-| Hot | Hot ranking |
-| Graduated | Recently graduated / launched |
+You may also pass a native `type` as the first argument (e.g. `VOL_DAY_1`, `CAP`, `BURN`).
 
-CLI: `fourmeme token-rankings <orderBy> [--barType=HOUR24]`
+CLI: `fourmeme token-rankings <orderBy|type> [--barType=HOUR24] [--pageSize=20] [--symbol=] [--version=] …`

package/skills/four-meme-integration/scripts/8004-balance.ts

@@ -1,52 +1,52 @@
-#!/usr/bin/env node
-/**
- * EIP-8004 NFT – query balance (number of identity NFTs owned by address).
- *
- * Usage:
- *   npx tsx 8004-balance.ts <ownerAddress>
- *
- * Optional env: BSC_RPC_URL, 8004_NFT_ADDRESS.
- * Default contract: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 (BSC).
- */
-
-import { createPublicClient, http, parseAbi } from 'viem';
-import { bsc } from 'viem/chains';
-
-const DEFAULT_8004_NFT = '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432' as const;
-
-const ABI = parseAbi(['function balanceOf(address owner) view returns (uint256)']);
-
-function isAddress(s: string): boolean {
-  return /^0x[0-9a-fA-F]{40}$/.test(s);
-}
-
-async function main() {
-  const ownerAddress = process.argv[2];
-  if (!ownerAddress || !isAddress(ownerAddress)) {
-    console.error('Usage: 8004-balance.ts <ownerAddress>');
-    console.error('  ownerAddress: 0x... wallet address');
-    process.exit(1);
-  }
-
-  const contractAddress = (process.env['8004_NFT_ADDRESS'] || process.env.EIP8004_NFT_ADDRESS || DEFAULT_8004_NFT) as `0x${string}`;
-  const rpcUrl = process.env.BSC_RPC_URL || 'https://bsc-dataseed.binance.org';
-
-  const client = createPublicClient({
-    chain: bsc,
-    transport: http(rpcUrl),
-  });
-
-  const balance = await client.readContract({
-    address: contractAddress,
-    abi: ABI,
-    functionName: 'balanceOf',
-    args: [ownerAddress as `0x${string}`],
-  });
-
-  console.log(JSON.stringify({ owner: ownerAddress, balance: Number(balance) }, null, 2));
-}
-
-main().catch((e) => {
-  console.error(e.message || e);
-  process.exit(1);
-});
+#!/usr/bin/env node
+/**
+ * EIP-8004 NFT – query balance (number of identity NFTs owned by address).
+ *
+ * Usage:
+ *   npx tsx 8004-balance.ts <ownerAddress>
+ *
+ * Optional env: BSC_RPC_URL, 8004_NFT_ADDRESS.
+ * Default contract: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 (BSC).
+ */
+
+import { createPublicClient, http, parseAbi } from 'viem';
+import { bsc } from 'viem/chains';
+
+const DEFAULT_8004_NFT = '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432' as const;
+
+const ABI = parseAbi(['function balanceOf(address owner) view returns (uint256)']);
+
+function isAddress(s: string): boolean {
+  return /^0x[0-9a-fA-F]{40}$/.test(s);
+}
+
+async function main() {
+  const ownerAddress = process.argv[2];
+  if (!ownerAddress || !isAddress(ownerAddress)) {
+    console.error('Usage: 8004-balance.ts <ownerAddress>');
+    console.error('  ownerAddress: 0x... wallet address');
+    process.exit(1);
+  }
+
+  const contractAddress = (process.env['8004_NFT_ADDRESS'] || process.env.EIP8004_NFT_ADDRESS || DEFAULT_8004_NFT) as `0x${string}`;
+  const rpcUrl = process.env.BSC_RPC_URL || 'https://bsc-dataseed.binance.org';
+
+  const client = createPublicClient({
+    chain: bsc,
+    transport: http(rpcUrl),
+  });
+
+  const balance = await client.readContract({
+    address: contractAddress,
+    abi: ABI,
+    functionName: 'balanceOf',
+    args: [ownerAddress as `0x${string}`],
+  });
+
+  console.log(JSON.stringify({ owner: ownerAddress, balance: Number(balance) }, null, 2));
+}
+
+main().catch((e) => {
+  console.error(e.message || e);
+  process.exit(1);
+});