gmx-liquidity

gmx-liquidity is a skill for Claude Code, Codex from gmx-io/gmx-ai. It costs 45 tokens per session (5,669 once invoked), scanned A, original, MIT.

A tool for adding, removing, or moving trading liquidity in GMX V2, a platform for perpetual and spot cryptocurrency trading. It works with GM pools and GLV vaults on Arbitrum, Avalanche, and Botanix.

In plain words
What is it for?
It is for depositing into or withdrawing from GM pools and GLV vaults, shifting liquidity between pools, and checking pool data.
Why use it?
It provides one way to manage deposits, withdrawals, transfers between pools, and pool information across the supported networks.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit It is for depositing into or withdrawing from GM pools and GLV vaults, shifting liquidity between pools, and checking pool data.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/gmx-io/gmx-ai/gmx-liquidity
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add gmx-io/gmx-ai --skill gmx-liquidity
Clone the repo
git clone --depth 1 https://github.com/gmx-io/gmx-ai

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for gmx-liquidity

README.md
[![agentmods](https://agentmods.dev/badge/skills/gmx-io/gmx-ai/gmx-liquidity/github.svg)](https://agentmods.dev/skills/gmx-io/gmx-ai/gmx-liquidity)
Your own site
<a href="https://agentmods.dev/skills/gmx-io/gmx-ai/gmx-liquidity"><img src="https://agentmods.dev/badge/skills/gmx-io/gmx-ai/gmx-liquidity/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for gmx-liquidity

Your own site · 80×15
<a href="https://agentmods.dev/skills/gmx-io/gmx-ai/gmx-liquidity"><img src="https://agentmods.dev/badge/skills/gmx-io/gmx-ai/gmx-liquidity.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 45 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 5,669 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00045 $0.05669
Opus 5 $0.00023 $0.02835
Sonnet 5 $0.00009 $0.01134
Haiku 4.5 $0.00005 $0.00567

Measured 12d ago against content hash d47cc931b756, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

gmx-liquidity scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.well-known/skills/gmx-liquidity/SKILL.md · 580 lines

How it starts

The opening of the file, as written. The whole thing — 580 lines — stays where its author put it; the contents beside it link to each section on GitHub.

GMX Liquidity Skill

Overview

GMX V2 has two liquidity layers that back perpetual and spot trading:

  • GM Pools — Single-market liquidity pools. Each GM pool backs one market (e.g., ETH/USD) and is composed of a long token and short token. Depositing mints GM tokens (LP tokens); withdrawing burns them.
  • GLV Vaults (GMX Liquidity Vaults) — Multi-market vaults that hold multiple GM tokens and auto-rebalance across constituent pools. Depositing mints GLV tokens; withdrawing burns them.

Supported chains:

Chain Chain ID Native Token GLV Vaults
Arbitrum 42161 ETH Yes
Avalanche 43114 AVAX Yes
Botanix 3637 BTC No (contracts deployed, no vaults configured)

Execution model: All write operations use a two-step async pattern:

  1. User creates a request (deposit/withdrawal/shift) via ExchangeRouter or GlvRouter multicall
  2. Keeper executes the request with oracle prices (typically 1–30 seconds later)

The user pays an execution fee (in native token) upfront to cover keeper gas costs. Excess fee is refunded.

Integration paths:

  • SDK (@gmx-io/sdk) — Read pool data, balances, and market info. Write operations (deposit/withdraw) are not yet in the SDK.
  • Contract-level (viem) — Full read + write via ExchangeRouter.multicall() and GlvRouter.multicall().

This skill complements gmx-trading which covers perpetual trading and swaps.

GM Pools

Each GM pool is a pair of tokens backing a specific market:

  • Long token — The asset (e.g., WETH for ETH/USD)
  • Short token — The stablecoin (e.g., USDC)
  • GM token — The LP token representing a share of the pool

Deposits can be:

  • Balanced — Deposit both long and short tokens proportionally. Lower fees (helps balance the pool).
  • Single-sided — Deposit only one token. The protocol swaps a portion internally. Higher fees if it imbalances the pool.

Withdrawals burn GM tokens and return the underlying long and short tokens. A withdrawal can specify minLongTokenAmount and minShortTokenAmount for slippage protection.

Read the full file on GitHub · 580 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 580 lines · 45 tokens per session scan A d47cc931b756

Subscribe to this mod's changes

gmx-liquidity is a skill published in the GitHub repository gmx-io/gmx-ai (11 stars, last pushed 5mo ago), licensed MIT. It adds 45 tokens to every session and 5,669 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

awaken-agent-skills

Awaken DEX trading and market data operations for agents.

Awaken-Finance/awaken-agent-skills · 18 tokens

SunSwap DEX Trading

Execute token swaps, manage liquidity, and query market data on SunSwap DEX via the sun-cli.

BofAI/skills · 27 tokens

ct-alpha

Crypto Twitter intelligence and alpha research. Search X/Twitter for real-time crypto narratives, trending tokens, yield strategies, smart money signals, and protocol research. Features TweetRank (PageRank-inspired credibility scoring), multi-signal token detection, coordinated raid detection, and dynamic tool…

sendaifun/skills · 71 tokens

crypto-token-analysis

Deep-dive framework for analyzing crypto tokens — market data, liquidity health, tokenomics, unlock schedules, and risk assessment. Combines on-chain data, API queries, and multi-source validation to generate actionable investment verdicts.

kevinnft/ai-agent-skills · 49 tokens

portkey-eoa-agent-skills

Portkey EOA wallet lifecycle and asset operations for creating, importing, listing, backing up, selecting, and deleting wallets; querying tokens, NFTs, prices, balances, and history; and performing transfers, approvals, bridge, view, send, and fee estimation operations on AElf. Use by default for direct EOA wallets…

Portkey-Wallet/eoa-agent-skills · 93 tokens

eforest-agent-skills

Skill "eforest-agent-skills" from eforest-finance/eforest-agent-skills, covering eforest agent skill, when to use, capabilities, safe usage rules and command recipes.

eforest-finance/eforest-agent-skills · 17 tokens