percolator-cli

Manage perpetual futures markets on Solana via command-line interface.

Updated Feb 7, 2026
One-click install
npx skills add https://github.com/ChartGains/percolator --skill percolator-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: percolator-cli
Source: https://github.com/ChartGains/percolator/tree/main
Command: npx skills add https://github.com/ChartGains/percolator --skill percolator-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @solana/web3.js, @solana/spl-token, commander, zod, @pythnetwork/pyth-solana-receiver, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enables users to interact with the Percolator perpetuals protocol on Solana, allowing for the deployment and management of decentralized perpetual futures markets.

Core Features & Use Cases

  • Market Deployment: Deploy and configure new perpetual markets with customizable risk parameters.
  • Trading: Execute trades (long/short) against liquidity pools using various methods (CPI, direct).
  • Risk Management: Monitor and adjust market risk parameters like margin requirements and liquidation thresholds.
  • Use Case: A user wants to deploy a new SOL/USD perpetual market on Solana. They can use this Skill to initialize the market, set risk parameters, add initial liquidity, and start accepting trades.

Quick Start

Use the percolator-cli skill to initialize a new market on devnet.

Frequently Asked Questions about percolator-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a perpetual futures market on Solana?

You can deploy a new perpetual market on Solana by using the CLI to initialize the market, configure custom risk parameters like margin requirements, add initial liquidity, and start accepting long and short trades.

What is an inverted perpetual market and does this CLI support it?

An inverted perpetual market is a market type supported by this CLI. The command-line interface manages the deployment and operation of both standard and inverted perpetual futures markets on the Solana blockchain.

How do I execute trades on a Solana perpetuals protocol?

You execute trades on a Solana perpetuals protocol by running CLI commands to take long or short positions against liquidity pools. The interface supports both CPI and direct execution methods for trade operations.

Can I use Pyth network oracle data with Solana perpetual futures markets?

Yes, you can use Pyth network oracle data with Solana perpetual futures markets. The CLI integrates the Pyth Solana receiver dependency to support accurate price feeds for market deployment and binary market settlement workflows.

How do I adjust risk parameters like margin requirements for a DeFi perpetual market?

You adjust risk parameters for a DeFi perpetual market by using the CLI to monitor and modify margin requirements and liquidation thresholds. This ensures proper risk management for the deployed liquidity pools.

What is the best way to settle a binary market on a Solana DEX?

The best way to settle a binary market on a Solana DEX is using the CLI's binary market settlement workflows. This allows administrators to finalize market outcomes accurately within the Percolator protocol.