Twilight Protocol Agent Skills

Claude Code skills and API references for autonomous trading on Twilight Protocol — a zero-knowledge inverse perpetual exchange.

What's in this repo

Skills (.claude/skills/)

Skills are invoked with /skill-name in Claude Code. They give the agent full context on how to use the Twilight trading infrastructure.

Skill	Trigger	What it does
/twilight-trader	"open a trade", "check balance", "fund account", "estimated funding rate"	Full CLI reference for the relayer-cli — wallet management, BTC onboarding, ZkOS account funding, opening/closing leveraged positions, market data, portfolio tracking, estimated funding rate
/twilight-strategies	"show strategies", "best hedging strategy", "funding arb"	Query the Twilight Strategy API for live trading strategies with real-time P&L calculations across Twilight, Binance, and Bybit

Strategy API

Live strategy calculations powered by real-time WebSocket feeds from Binance and Bybit.

Base URL: https://strategy.lunarpunk.xyz Auth: x-api-key: 123hEll@he

# Get top 5 profitable strategies
curl -H "x-api-key: 123hEll@he" "https://strategy.lunarpunk.xyz/api/strategies?profitable=true&limit=5"

# Run a custom delta-neutral strategy
curl -X POST -H "x-api-key: 123hEll@he" -H "Content-Type: application/json" \
  -d '{"twilightPosition":"SHORT","twilightSize":200,"twilightLeverage":10,"binancePosition":"LONG","binanceSize":200,"binanceLeverage":10}' \
  https://strategy.lunarpunk.xyz/api/strategies/run

# Get live market data
curl -H "x-api-key: 123hEll@he" https://strategy.lunarpunk.xyz/api/market

Endpoint	Method	Auth	Description
/api/health	GET	No	Health check
/api/market	GET	Yes	Live prices, funding rates, spreads, pool skew
/api/strategies	GET	Yes	All strategies with live calculations
/api/strategies/:id	GET	Yes	Single strategy by ID
/api/strategies/run	POST	Yes	Run a custom strategy with your own params
/api/impact	POST	Yes	Simulate trade impact on pool
/api/categories	GET	Yes	List categories, risk levels, filter options
/api/pool	GET/POST	Yes	Get/update pool configuration

Strategy Filters (query params on /api/strategies):

• ?category=Delta-Neutral — filter by category
• ?risk=LOW — filter by risk level
• ?profitable=true — only profitable strategies
• ?minApy=50 — minimum APY threshold
• ?limit=10 — max results

Relayer CLI Quick Reference

The relayer-cli binary from nyks-wallet v0.1.0-relayer-cli handles all on-chain operations.

# Create wallet
relayer-cli wallet create --wallet-id my-wallet

# Fund ZkOS trading account
relayer-cli zkaccount fund --amount 5000

# Open 5x long
relayer-cli order open-trade --account-index 0 --side LONG --entry-price 66700 --leverage 5

# Close trade
relayer-cli order close-trade --account-index 0

# Unlock account after settlement (required before reuse)
relayer-cli order unlock-close-order --account-index 0

# Rotate account for next trade
relayer-cli zkaccount transfer --account-index 0

# Send tokens to another address
relayer-cli wallet send --to twilight1abc... --amount 5000 --denom sats

# Market data
relayer-cli market price
relayer-cli market market-stats

Mainnet Endpoints

Service	URL
LCD (REST)	https://lcd.twilight.org
RPC	https://rpc.twilight.org
ZkOS Server	https://zkserver.twilight.org
Relayer API	https://api.ephemeral.fi/api
Strategy API	https://strategy.lunarpunk.xyz
Explorer	https://explorer.twilight.org

Key Concepts

• Inverse perpetuals: margin in BTC (sats), PnL in sats
• Fees: chain transactions are zero-fee; exchange operations carry fill and settlement fees
• Funding: applied every 1 hour (vs 8h on Binance/Bybit) — use /twilight-trader to estimate the next rate
• ZkOS accounts: privacy-preserving, two states — Coin (idle) / Memo (order active)
• Account rotation: after closing a trade, run unlock-close-order then zkaccount transfer before opening a new one
• Max leverage: 50x, max position: 20% of pool equity

Related Repos

• nyks-wallet — Rust SDK + CLI for trading (v0.1.0-relayer-cli)
• twilight-pool — Frontend (Next.js)
• twilight-strategy-tester — Strategy visualizer with live Binance/Bybit feeds