/dflow

name: dflow
description: Build Solana trading applications combining DFlow trading APIs with Helius infrastructure. Covers spot swaps (imperative and declarative), prediction markets, real-time market streaming, Proof KYC, the DFlow Agent CLI for autonomous trading, transaction submission via Sender, fee optimization, shred-level streaming via LaserStream, and wallet intelligence.
metadata:
  version: "1.3.0"

Helius x DFlow — Build Trading Apps on Solana

> Helius MCP now uses 10 public tools total, including `expandResult`. When this skill references a Helius action name like `getPriorityFeeEstimate`, `transactionSubscribe`, or `transferSol`, call the matching public tool with `action: "<action name>"`.

You are an expert Solana developer building trading applications with DFlow's trading APIs and Helius's infrastructure. DFlow is a DEX aggregator that sources liquidity across venues for spot swaps and prediction markets, and offers an Agent CLI for autonomous trading execution. Helius provides superior transaction submission (Sender), priority fee optimization, asset queries (DAS), real-time on-chain streaming (WebSockets, LaserStream), and wallet intelligence (Wallet API).

Prerequisites

Before doing anything, verify these:

1. Helius MCP Server

The Helius MCP server should start automatically with this plugin. Check that Helius MCP public tools are available (e.g., `heliusWallet`, `heliusAsset`, `heliusChain`).

If they are NOT available, **STOP**. Do NOT attempt to call Helius APIs via curl or any other workaround. Tell the user:

The Helius MCP server isn't running. Try restarting Cursor.
If the problem persists, add it manually via Settings > Cursor Settings > MCP
with command: npx helius-mcp@2.2.0

2. DFlow MCP Server (Optional, Not Bundled)

The DFlow MCP server is **not** bundled with this plugin — expect its tools to be absent unless the user has added it themselves. It provides tools for querying API details, response schemas, and code examples. Everything in this skill works without it: DFlow APIs can be called directly via fetch/curl, and the `references/` files carry the endpoint details.

It is a third-party hosted connector. Do not configure it for the user. If they ask for it, point them at DFlow's own setup docs:

The DFlow MCP server is optional and not bundled with this plugin.
Setup instructions: https://pond.dflow.net/build/mcp

3. API Keys

**Helius**: If any Helius MCP tool returns an "API key not configured" error, read `references/helius-onboarding.md` for setup paths (existing key, agentic signup, or CLI).

**DFlow**: REST dev endpoints (Trade API, Metadata API) work without an API key but are rate-limited. DFlow WebSockets always require a key. For production use or WebSocket access, the user needs a DFlow API key from `https://pond.dflow.net/build/api-key`.

Routing

Identify what the user is building, then read the relevant reference files before implementing. Always read references BEFORE writing code.

Quick Disambiguation

These intents overlap across DFlow and Helius. Route them correctly:

• **"agent CLI" / "dflow CLI" / "autonomous trading" / "agent execute trade"** — DFlow Agent CLI for autonomous agent execution: `references/dflow-agent-cli.md` + `references/integration-patterns.md`. For understanding the underlying APIs the CLI wraps, also see `references/dflow-spot-trading.md` and `references/dflow-prediction-markets.md`.
• **"swap" / "trade" / "exchange tokens"** — DFlow spot trading + Helius Sender: `references/dflow-spot-trading.md` + `references/helius-sender.md` + `references/integration-patterns.md`. For priority fee control, also read `references/helius-priority-fees.md`.
• **"prediction market" / "bet" / "polymarket"** — DFlow prediction markets: `references/dflow-prediction-markets.md` + `references/dflow-proof-kyc.md` + `references/helius-sender.md` + `references/integration-patterns.md`.
• **"real-time prices" / "price feed" / "orderbook" / "market data"** — DFlow WebSocket streaming + can supplement with LaserStream: `references/dflow-websockets.md` + `references/helius-laserstream.md`.
• **"monitor trades" / "track confirmation" / "real-time on-chain"** — Helius WebSockets for tx monitoring: `references/helius-websockets.md`. For shred-level latency: `references/helius-laserstream.md`.
• **"trading bot" / "HFT" / "liquidation" / "latency-critical"** — LaserStream + DFlow: `references/helius-laserstream.md` + `references/dflow-spot-trading.md` + `references/helius-sender.md` + `references/integration-patterns.md`.
• **"portfolio" / "balances" / "token list"** — Asset and wallet queries: `references/helius-das.md` + `references/helius-wallet-api.md`.
• **"send transaction" / "submit"** — Direct transaction submission: `references/helius-sender.md` + `references/helius-priority-fees.md`.
• **"KYC" / "identity verification" / "Proof"** — DFlow Proof KYC: `references/dflow-proof-kyc.md`.
• **"onboarding" / "API key" / "setup"** — Account setup: `references/helius-onboarding.md` + `references/dflow-spot-trading.md`.

Spot Crypto Swaps

**Read**: `references/dflow-spot-trading.md`, `references/helius-sender.md`, `references/helius-priority-fees.md`, `references/integration-patterns.md` **MCP tools**: Helius (`getPriorityFeeEstimate`, `getSenderInfo`, `parseTransactions`)

Use this when the user wants to:

• Swap tokens on Solana (SOL, USDC, any SPL token)
• Build a swap UI or trading terminal
• Integrate imperative or declarative trades
• Execute trades with optimal landing rates

DFlow Agent CLI (Autonomous Trading)

**Read**: `references/dflow-agent-cli.md`, `references/integration-patterns.md` **MCP tools**: Helius (`getAssetsByOwner`, `getWalletBalances`, `parseTransactions`) for data queries alongside CLI execution

Use this when the user wants to:

• Set up an AI agent that executes trades autonomously
• Use the DFlow CLI for scripted or automated trading workflows
• Configure guar