What is the DuelDuck Prediction API?

The DuelDuck Prediction API is a REST-style API and TypeScript SDK that allows Web3 developers to embed on-chain prediction markets (duels) into their applications. It handles smart contracts, escrow, reward distribution, and fee logic while you maintain full control over the user interface.

Do my users interact with DuelDuck directly?

No. You keep your own design and user flow. DuelDuck works in the background handling the smart contract mechanics. Your users never see DuelDuck branding or interface — it's completely white-label.

Who controls the duel outcomes?

You do. DuelDuck is oracle-free by design. You resolve duels manually via the API or admin panel, giving you full control over specialized or community-centric markets.

Can I use my own SPL token?

Yes. You can use SOL, USDC, USDT, or any custom SPL token for entry fees and payouts.

Is there a test environment?

Yes. We provide a full test environment on Solana Devnet, a TypeScript SDK with full type safety, comprehensive documentation, and example code repositories.

How long does integration take?

Most teams complete integration in under 48 hours. We provide SDK, documentation, example code, video tutorials, and direct Telegram/Discord support.

What blockchain does DuelDuck use?

DuelDuck is built exclusively on Solana, leveraging its high throughput (65,000 TPS), sub-second finality (~400ms), and minimal transaction fees ($0.00025 average).

Is DuelDuck audited and secure?

Yes. Our smart contracts are battle-tested with over $2.5M in volume processed securely. We use Anchor framework, and all funds are held in program-derived addresses (PDAs) until duel resolution.

What fees does DuelDuck charge?

Connecting to the API is completely free with no upfront costs. You set your own commission (up to 10%) on duels. DuelDuck takes a small platform fee (0.5%-2.5%) from your commission based on monthly volume. Under $1,000/month volume? Zero platform fee.

How do I get paid my commissions?

Commissions are automatically sent to your designated Solana wallet address immediately when a duel is resolved. No manual claiming required.

Can I create duels with multiple outcomes?

Currently, DuelDuck supports binary (two-outcome) duels: Yes/No, Team A/Team B, etc. Multi-outcome markets are on our roadmap.

What happens if a duel needs to be cancelled?

You can cancel unresolved duels via the API. All entry fees are automatically refunded to participants in full, minus network transaction fees.

Do you provide analytics and reporting?

Yes. The API includes endpoints for retrieving duel statistics, volume metrics, user participation data, and commission reports.

Is there rate limiting on the API?

Standard integrations have generous rate limits (1000 requests/minute). Enterprise partners can request higher limits. Real-time data is available via WebSocket connections.

Can I white-label the entire experience?

Absolutely. DuelDuck is designed as invisible infrastructure. Your users interact only with your UI, your branding, and your domain.

What programming languages are supported?

We provide official SDKs for TypeScript/JavaScript. The REST API can be used with any language including Python, Rust, Go, PHP, and more.

LIMITED OFFERNow new partner gets free API integration support from the DuelDuck team

Launch your prediction markets
with Duel Duck API

Add on-chain prediction markets to your product without building backend infrastructure, smart contracts, or reward distribution logic from scratch.

Free to start

48-hour integration

Prediction fee revenue up to 10%

SPL token support

View Documentation Get API Access

No upfront costs to start
Battle-tested smart contracts
Dedicated integration support

LEGENDS.FUN

Steps to connect your AI agent

Create your API Key

Generate your first API Key

********************************

Set up MCP

Run this command in your terminal to connect Claude to your AI tool

claude mcp add --duelduck user --transport
http claude

claude mcp add --duelduck user --transport
http claude

What is Duel Duck API?

1.Ready-made prediction market backend

DuelDuck API lets you create, manage, and resolve prediction markets without building the backend, smart contracts, or reward logic yourself.

2.MCP tools for faster integration

We provide MCP tools and integration guidance to help your team connect DuelDuck API to your product faster.

3.Your frontend, our infrastructure

You control the user experience on your platform, while DuelDuck handles voting logic, on-chain execution, settlement, and automated rewards.

View Documentation Get API Access

Why Build with DuelDuck API?

Get API Access

Free to start

Create your first API key and start integrating without upfront costs or subscription fees.

No backend needed

Launch prediction markets on your own platform without building your own backend, voting logic, or payout system.

Player-funded liquidity

Prediction pools are funded by user votes. You don't need to provide separate liquidity - each market grows with your audience's activity.

Built-In Monetization

As a prediction creator, you define your own commission (up to 10%). You earn revenue after users participate and win in your predictions.

Any SPL Token Support

Create predictions with SOL, USDC, or other SPL tokens used by your project.

Fixed price Predictions

Users pays one defined amount per prediction

Will Bitcoin reach $100,000 before December 31, 2026?

Ticket price2

Flexible Stake Predictions

Users choose how much to stake within a set range

Will Bitcoin reach $100,000 before December 31, 2026?

Ticket price41016

Coming soon

User-created Predictions

Let users create and resolve their own predictions, while you keep control through dashboard settings

	Duel Duck API	Building on Your Own
Backend logic	Included	Build yourself
Time to Launch	< 48 hours	Months
Reward Distribution	Automated	Build yourself
Upfront cost	Free	$50K+
Maintenance	Handled for you	Your team

Backend logic

IncludedDuel Duck API

Build yourselfBuilding on Your Own

Time to Launch

< 48 hoursDuel Duck API

MonthsBuilding on Your Own

Reward Distribution

AutomatedDuel Duck API

Build yourselfBuilding on Your Own

Upfront cost

FreeDuel Duck API

$50K+Building on Your Own

Maintenance

Handled for youDuel Duck API

Your teamBuilding on Your Own

GET STARTED TODAY

0%Free

pay nothing if your income from commissions is under $1,000 / month

25%

if your income from commissions isfrom $1,000 to $10,000

20%

if your income from commissions isfrom $10,001 to $50,000

15%

if your income from commissions isfrom $50,001 to $100,000

10%

if your income from commissions startsfrom $100,001

DANBusiness Developer

LIMITED OFFER

FREE CALL TO HELP YOU GET STARTED

Book a call and we will help you integrate Duel Duck API in your project

Book a call

Self guided setup

FOLLOW THE DOCUMENTATION

Use our step-by-step guide to create your API key, connect DuelDuck API, and start adding prediction markets to your platform.

View Documentation

Reward Pool

The total accumulated entry fees for a duel, minus platform and operator commissions. Distributed proportionally among winners upon resolution.

Commission

A percentage fee (up to 10%) that the duel creator earns from the reward pool. Automatically deducted and sent to your wallet on resolution.

Resolution

A binary prediction market with two possible outcomes (Yes/No, Team A/Team B). Users pay an entry fee to pick a side, and winners split the reward pool.

SPL Token

Solana Program Library Token - the fungible token standard on Solana. DuelDuck supports any SPL token including SOL, USDC, and custom project tokens.

PDA (Program Derived Address)

Secure Solana wallet addresses controlled by smart contracts. DuelDuck uses PDAs to hold duel funds in escrow until resolution.

White-Label

A product or service that can be rebranded by the buyer. DuelDuck API is fully white-label - users never see DuelDuck branding.

Launch your prediction marketswith Duel Duck API