gmgn-cli 1.2.2 → 1.2.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/Readme.md +35 -4
- package/Readme.zh.md +35 -5
- package/dist/client/OpenApiClient.d.ts +25 -1
- package/dist/client/OpenApiClient.d.ts.map +1 -1
- package/dist/client/OpenApiClient.js +11 -6
- package/dist/client/OpenApiClient.js.map +1 -1
- package/dist/commands/portfolio.d.ts.map +1 -1
- package/dist/commands/portfolio.js +23 -0
- package/dist/commands/portfolio.js.map +1 -1
- package/dist/commands/swap.d.ts.map +1 -1
- package/dist/commands/swap.js +105 -3
- package/dist/commands/swap.js.map +1 -1
- package/dist/commands/track.js +1 -1
- package/dist/commands/track.js.map +1 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +3 -2
- package/dist/config.js.map +1 -1
- package/package.json +1 -1
- package/skills/gmgn-cooking/SKILL.md +1 -1
- package/skills/gmgn-portfolio/SKILL.md +94 -3
- package/skills/gmgn-swap/SKILL.md +131 -29
- package/skills/gmgn-token/SKILL.md +43 -1
- package/skills/gmgn-track/SKILL.md +4 -10
|
@@ -16,7 +16,7 @@ Use the `gmgn-cli` tool to query on-chain tracking data based on the user's requ
|
|
|
16
16
|
|
|
17
17
|
## Core Concepts
|
|
18
18
|
|
|
19
|
-
- **`follow-wallet` vs `kol` vs `smartmoney`** — Three distinct data sources. `follow-wallet` returns trades from wallets the user has personally followed on the GMGN platform (user-specific
|
|
19
|
+
- **`follow-wallet` vs `kol` vs `smartmoney`** — Three distinct data sources. `follow-wallet` returns trades from wallets the user has personally followed on the GMGN platform (user-specific; the follow list is resolved from the GMGN user account bound to the API Key). `kol` and `smartmoney` return trades from platform-tagged public wallet lists (not user-specific). Never substitute one for another.
|
|
20
20
|
|
|
21
21
|
- **KOL (Key Opinion Leader)** — Wallets publicly identified as influencers or well-known traders on GMGN. Tagged as `renowned` in the platform's wallet label system. Their trades carry social/marketing signal, not necessarily alpha.
|
|
22
22
|
|
|
@@ -60,8 +60,7 @@ Use the `gmgn-cli` tool to query on-chain tracking data based on the user's requ
|
|
|
60
60
|
## Prerequisites
|
|
61
61
|
|
|
62
62
|
- `gmgn-cli` installed globally — if missing, run: `npm install -g gmgn-cli`
|
|
63
|
-
- `GMGN_API_KEY` configured in `~/.config/gmgn/.env`
|
|
64
|
-
- `GMGN_PRIVATE_KEY` required only for `track follow-wallet`; not needed for `track kol` / `track smartmoney`
|
|
63
|
+
- `GMGN_API_KEY` configured in `~/.config/gmgn/.env` — required for all sub-commands; no private key needed
|
|
65
64
|
|
|
66
65
|
## Rate Limit Handling
|
|
67
66
|
|
|
@@ -95,10 +94,6 @@ When a request returns `429`:
|
|
|
95
94
|
echo 'GMGN_API_KEY=<key_from_user>' > ~/.config/gmgn/.env
|
|
96
95
|
chmod 600 ~/.config/gmgn/.env
|
|
97
96
|
```
|
|
98
|
-
If the user also needs `track follow-wallet`, append the private key:
|
|
99
|
-
```bash
|
|
100
|
-
echo 'GMGN_PRIVATE_KEY="<pem_content_from_step_1>"' >> ~/.config/gmgn/.env
|
|
101
|
-
```
|
|
102
97
|
|
|
103
98
|
## Usage Examples
|
|
104
99
|
|
|
@@ -308,13 +303,12 @@ To research any token surfaced by smart money activity, follow [`docs/workflow-t
|
|
|
308
303
|
|
|
309
304
|
## Safety Constraints
|
|
310
305
|
|
|
311
|
-
- **`track follow-wallet` requires `GMGN_PRIVATE_KEY`** — this signing key is linked to your GMGN account. It is used for authentication only (no on-chain access), but must be protected like any credential. Never expose it in logs or command output.
|
|
312
306
|
- **`follow-wallet` reveals your following list** — results expose which wallets you have followed on GMGN. Do not share raw output in public channels.
|
|
313
307
|
- **`track kol` / `track smartmoney` expose no personal data** — these use API Key auth only and return platform-tagged public wallet activity. Safe to share raw output.
|
|
314
308
|
|
|
315
309
|
## Notes
|
|
316
310
|
|
|
317
|
-
-
|
|
318
|
-
- `track follow-wallet`
|
|
311
|
+
- All sub-commands use normal auth (API Key only, no signature required)
|
|
312
|
+
- `track follow-wallet` returns trades from wallets followed on the GMGN platform; the follow list is resolved automatically from the GMGN user account bound to the API Key — `--wallet` is optional
|
|
319
313
|
- Use `--raw` to get single-line JSON for further processing
|
|
320
314
|
- `track kol` / `track smartmoney` `--side` is a **client-side filter** — the CLI fetches all results then filters locally; it is NOT sent to the API
|