What It Is
The Nile Markets OpenClaw skill is an agentskills.io-format skill published on ClawHub. It provides read-only access to the Nile Markets protocol by delegating all queries to the Nile MCP server at mcp.nilemarkets.com. The skill exposes 12 MCP tools for querying pool state, positions, oracle prices, account balances, and fee analytics.
Installation
Install the ClawHub CLI globally, then install the skill:
npm install -g clawhub
clawhub install nile-markets
Prerequisites
Set the MCP server URL as an environment variable before using the skill:
export NILE_MCP_URL="https://mcp.nilemarkets.com/api/mcp"
.bashrc, .zshrc, etc.) for persistence.
All tools are read-only. They return JSON responses with protocol (name + version), network, and data fields. Tools sourcing data from the subgraph include _meta.lastIndexedBlock for freshness verification.
Pool and Protocol
| Tool | Description | Input |
|---|
get_pool_state | Liquidity pool metrics: total assets, shares, share price, exposure, utilization, fees | None |
get_protocol_mode | Operating mode: NORMAL, DEGRADED, REDUCE_ONLY, or PAUSED | None |
Positions
| Tool | Description | Input |
|---|
get_positions | Positions for a specific account | account (required), status?, first?, skip? |
get_position | Single position with real-time PnL via RPC | id (required) |
search_positions | Search all positions with filters | side?, tenor?, status?, minNotional?, first?, skip? |
Oracle and Pricing
| Tool | Description | Input |
|---|
get_forward_price | EUR/USD forward price for a specific tenor | tenor? (1D, 1W, 1M, or omit for all) |
get_oracle_state | Full oracle state: spot, all forward prices, validity | None |
Accounts and Fees
| Tool | Description | Input |
|---|
get_account | Account margin: collateral, locked, available, position count | address (required) |
get_daily_stats | Daily volume, fees, position opens/closes | days? (default 7, max 90) |
get_pool_transactions | Historical vault deposits and withdrawals | first?, skip? |
get_fee_events | Fee event breakdown (trading, liquidation, termination, oracle) | first?, skip? |
Simulation
| Tool | Description | Input |
|---|
simulate_open_position | Preview margin, fee, and entry strike for a new position | side, tenor, notional, from? |
Example Queries
Ask your agent questions naturally once the skill is loaded:
- “What’s the current Nile Markets pool utilization and share price?” — uses
get_pool_state
- “Show me all open positions for 0x1234…abcd” — uses
get_positions with status: "OPEN"
- “What are the EUR/USD forward prices for all tenors?” — uses
get_forward_price without a tenor filter
- “Is the Nile Markets protocol operating normally?” — uses
get_protocol_mode
- “How much margin for a 1000 USDC long 1-week position?” — uses
simulate_open_position
- “Find all open short positions above 5000 USDC notional” — uses
search_positions with filters
Verify Installation
Confirm the skill is installed and inspect its metadata:
clawhub list | grep nile-markets
clawhub inspect nile-markets
Limitations
The OpenClaw skill is read-only. It cannot:
- Open, close, or modify positions onchain
- Deposit or withdraw margin or vault funds
- Approve token spending or mint test tokens
- Manage wallets, private keys, or sign transactions
For write operations, connect to the Nile MCP server directly using any MCP-compatible client. See the MCP Server page for setup instructions, or use the Claude Code Plugin which includes both read and write tools.
The skill connects to the Nile Markets MCP server on Ethereum Sepolia. All protocol data is testnet-only with no real-world value. Tool schemas and response formats may change without notice during the M2 milestone.
