FAQs - DFlow

General
Spot Trading
Prediction Markets
Proof

Which wallets are supported?

Any Solana wallet that supports standard transaction signing.

What fees apply to a trade?

Network fees, optional priority fees, optional platform fees if you set them, and any DEX fees baked into the route. Slippage depends on market liquidity and trade size.

Do users need to KYC to trade?

Spot trades are non-custodial and don’t require KYC. Trading Kalshi prediction markets requires KYC via Proof before a wallet can receive outcome tokens.

What's the difference between sync and async trades?

Sync trades settle in one transaction. Async trades span multiple. Prediction market trades are always async because Kalshi market interactions can’t complete atomically onchain.

Does DFlow custody user funds?

No. Funds stay in the user’s wallet throughout the trade lifecycle.

Does DFlow support gas sponsorship?

Yes. Pass the sponsor parameter on /order to have a sponsor wallet cover the transaction fee.

Should I set platformFeeBps if I'm not collecting a fee?

No. The API factors platformFeeBps into slippage tolerance, so declaring a fee you don’t collect wastes slippage budget and gives users worse pricing. See Platform Fees.

Can I call /order directly from the browser?

No. The Trading API doesn’t set CORS headers, so browser requests are blocked. Proxy /order through your backend; most builders use an edge function (Cloudflare Workers, Vercel Edge Functions) to keep added latency low.

Does DFlow take positive slippage?

No.

How do I trade with native SOL?

Use the WSOL mint (So11111111111111111111111111111111111111112) as inputMint or outputMint and set wrapAndUnwrapSol=true. DFlow auto-wraps and unwraps SOL.

In POST /swap, what should destinationTokenAccount.address be for native SOL output?

Use the destination wallet address, not the wallet’s WSOL associated token account address.

What's the difference between price impact and slippage?

Slippage is the price drift between quote and execution. Price impact is the gap between market price and your effective fill, caused by your trade’s size relative to available liquidity.

How do I set a priority fee on a trade?

Pass prioritizationFeeLamports on /order as a lamport amount or one of auto, medium, high, veryHigh, disabled. See Priority Fees for the two fee modes.

How does DFlow handle multiple token accounts for the same mint?

DFlow uses the associated token account by default. To send output elsewhere, pass destinationTokenAccount on /order; output lands in that account even if it isn’t the ATA.

What's the maximum price impact allowed on a trade?

The server applies a default threshold and rejects trades that exceed it with a price_impact_too_high error. Override with priceImpactTolerancePct.

Why is my trade failing with "exceeded CUs meter at BPF instruction"?

The transaction hit its compute unit (CU) limit. Pass dynamicComputeUnitLimit=true on /order to have the API size the limit automatically.

Does DFlow support Pump.fun tokens?

Yes. Both on the bonding curve and after graduation to PumpSwap (Pump.fun’s native AMM).

What is JIT routing?

Traditional aggregators commit a route at quote time. DFlow’s JIT routing may refine the route at execution onchain, reflecting current conditions.

Why do intermediate token accounts and residual dust sometimes remain after a swap?

Multi-leg routes can create intermediate token accounts to pass value between legs.

Full consumption: If subsequent legs consume the intermediate amount, the accounts are closed.
Partial consumption: If a residual remains (venue rounding, leg constraints), the accounts stay open with small dust.

Does DFlow offer an intent-based swap?

Yes, as an opt-in. Most builders use /order (imperative): the app signs a fully constructed transaction and submits through its own RPC. The intent flow (GET /intent + POST /submit-intent) gives stronger sandwich resistance on standard SPL pairs: the user signs an open order without a fixed route, and DFlow submits the open order and fill atomically as a Jito bundle. Token-2022 mints (including Kalshi outcome tokens) aren’t supported on /intent.

Will DFlow support limit orders?

On the roadmap. No timeline yet.

Do I need an API key for prediction markets?

Not for developer endpoints. For production, request an API key to avoid rate limits.

What's the minimum USDC amount per order?

0.01 USDC. Some markets require more because the smallest purchasable unit is one contract and the floor depends on the contract price.

Can users buy a fractional contract?

No.

Does the input mint affect trade latency?

Yes. Using the settlement mint (USDC or CASH) directly is lowest latency. Any other input token adds a swap leg first, which is roughly 50ms of extra latency.

What are outcome tokens?

SPL tokens that represent positions in a prediction market. Each market has a YES outcome token and a NO outcome token.

Are markets settled in USDC or CASH?

DFlow supports both. A market settles in whichever settlement mint the outcome token mint belongs to. See Redeem Outcome Tokens for details.

How does the market lifecycle work?

Markets move through a fixed sequence from creation to settlement. The status defines what users and builders can do at each stage. See Monitor Market Lifecycle for the polling pattern.

Can users place prediction market orders at any time?

No. Kalshi’s clearinghouse has a weekly maintenance window on Thursdays 3:00 AM to 5:00 AM ET. Orders during that window aren’t cleared and the trade reverts. Your app should prevent submissions during the window.

What happens after a market resolves?

Users redeem outcome tokens for value according to the market result. This adds a redemption phase not present in spot trading: redemption flows, position closeout UX, and history/receipts UX.

What is a scalar outcome?

A resolution where both YES and NO are redeemable at a payout split set by Kalshi. See Scalar Outcomes.

What happens when an event is canceled before resolution?

Kalshi determines it as a scalar outcome.

How do I show order quotes to unverified users?

Omit userPublicKey from the /order request. The API returns the quote without requiring Proof verification.

Why does my first trade in a market trigger an account-creation cost?

If the market isn’t yet tokenized, /order initializes it on demand (creating the YES/NO outcome tokens) before the swap, which adds a small onchain account-creation fee. See Buy Outcome Tokens for the full flow.

How much does it cost to initialize a not-yet-tokenized market?

Roughly 0.02 SOL, paid in SOL (not USDC). Applies only when the market hasn’t been tokenized yet.

Who is responsible for market pre-initialization?

Any platform developer can pre-initialize a market before users trade it. Otherwise the first trade initializes the market and pays the cost, unless the trade is sponsored. DFlow pre-initializes some popular markets.

What's the difference between sponsor and predictionMarketInitPayer?

Are platform fees supported for prediction markets?

Yes, via platformFeeScale. See Add Platform Fees for the recipe.

How are prediction market fees structured?

Prediction market fees scale with trading volume across a fee tier system.

How are outcome tokens minted and where does liquidity come from?

Outcome tokens are minted when a user enters a position and burned when they redeem. Liquidity comes from Concurrent Liquidity Programs (CLPs).

Can I look up a specific market by ticker?

Yes. Kalshi market tickers map directly to the DFlow API. Use the Get Market endpoint for a single market or Get Event for all markets under an event.

How can I estimate the fill price before placing an order?

Use the Get Orderbook endpoint to fetch best bid and best ask. Stream changes via the Orderbook WebSocket channel for real-time updates.

Why are some active markets missing from my API results?

If you pass isInitialized=true on Events, Markets, or Series, the response only includes markets already tokenized through a DFlow trade. Markets live on Kalshi but never traded through DFlow are filtered out (common with short-duration markets like KXBTC15M, which start a new market every interval). Remove isInitialized to see all active markets. See Market Initialization Behavior.

How do I fetch market images?

Markets don’t have images yet (only events do). Image support is in progress. For now, fetch them from Kalshi directly.

Does DFlow support all Kalshi markets?

Yes, except combos. That includes entertainment, culture, celebrity, and the rest.

When should I use forecast history vs candlesticks?

Forecast history is only available for numerical events and is split by percentiles. It’s better for research or analysis than UI. Use candlesticks for charting and user-facing price history.

Why am I getting a 400 error when fetching candlesticks?

The maximum is 5,000 candlesticks per request. If startTs, endTs, and periodInterval would produce more, the request fails. Narrow the range or increase the interval.

Do DFlow WebSockets show offchain Kalshi trades too?

Yes. The DFlow WebSockets stream both onchain and offchain Kalshi trades.

Do my DFlow trades appear on Kalshi's trade WebSocket?

Yes. Onchain DFlow trades hit Kalshi’s offchain order books and appear on Kalshi’s trade WebSocket the same way offchain trades do.

Is there a WebSocket channel for open interest?

No. DFlow market tickers map directly to Kalshi tickers, so use Kalshi’s Market Ticker WebSocket for streaming open interest and Get Market for per-market snapshots.

When does USDC get pulled when using /submit-intent?

Only when the transaction lands onchain. /submit-intent builds the order and returns a transaction; USDC moves at execution, not at submit-intent time.

What are Milestones?

A Milestone groups a real-world occurrence (e.g. a game or match) by bundling related event tickers. It’s a separate grouping layer, not part of the Series → Event → Market hierarchy.related_event_tickers is a superset of primary_event_tickers. Primary event tickers are generally limited to moneyline, spread, and total markets for a sporting event. The relationship can be many-to-many: a single event ticker can appear in multiple Milestones.

Who provides KYC for Proof?

Stripe Identity.

Is there a fee to use Proof?

No.

Does Proof KYC work with embedded wallet providers like Privy?

Yes. Your app directs the user to https://dflow.net/proof to complete KYC, with a redirect URL to send them back to your app after verification.

If I use Proof to KYC Kalshi users, do I still need to geoblock?

Yes. Proof verifies user identity. Geoblocking is a separate jurisdictional concern for Kalshi prediction markets, which aren’t permitted everywhere.

Is Proof verification required to buy Kalshi outcome tokens on dev endpoints?

Yes. Buying outcome tokens requires Proof verification on both dev and production endpoints. Selling doesn’t require verification. See KYC for Kalshi.

How do I show outcome token quotes to unverified users?

Omit userPublicKey from the /order request. The API returns the quote without requiring Proof verification.

Why isn't my Proof redirect firing after verification?

Proof only redirects to https:, moz-extension://, or chrome-extension: URLs. Custom schemes (e.g. myapp://callback) silently fail. Native mobile apps should use universal links (iOS) or app links (Android). See redirect_uri parameter docs.

Documentation Index