Plurimarket

Documentation

Everything you need to know about Plurimarket — the fully permissionless, AI-resolved prediction market.

Overview

Plurimarket is a fully permissionless prediction market platform built on Base. Anyone can create a market about any future event, and all markets are resolved automatically by AI using real-time web search.

There are no gatekeepers, no approval processes, and no centralized resolution committees. The entire system is transparent, on-chain, and open source.

Key Features

  • • Permissionless: Anyone can create markets without approval
  • • AI-Resolved: GPT-5.2 with web search determines outcomes
  • • On-Chain: All trades and resolutions are recorded on Base
  • • Transparent: Resolution prompts are visible before you trade
  • • Open Source: Full codebase is public on GitHub

Getting Started

Before you can use Plurimarket, you'll need a wallet with the right tokens on the Base network.

1. Connect a Wallet

Click "Connect Wallet" to connect any Ethereum wallet via WalletConnect. We support MetaMask, Coinbase Wallet, Rainbow, and many others.

2. Get ETH on Base (for gas)

You need a small amount of ETH on Base to pay for transaction fees (gas). This is required for creating markets and placing bets.

How to get ETH on Base: Bridge from Ethereum mainnet using the official Base Bridge, or buy directly on Base through exchanges like Coinbase.

3. Get USDC on Base (for betting)

All bets on Plurimarket are placed in USDC on Base. This is the stablecoin used for all market transactions.

How to get USDC on Base: Bridge USDC from other chains using the Base Bridge, or swap ETH for USDC on Base using Uniswap.

Important: Base Network

Plurimarket runs on Base, an Ethereum Layer 2 network. Make sure your wallet is connected to Base (Chain ID: 8453) and that your ETH and USDC are on the Base network, not Ethereum mainnet or other chains.

Architecture

Plurimarket consists of three main components:

Smart Contracts

Solidity contracts on Base handle market creation, betting, and payouts.

Foundry / Solidity 0.8.19

Backend API

Serverless functions index markets and handle AI resolution testing.

AWS Lambda / Python

Frontend

React app for browsing markets, placing bets, and creating markets.

Next.js 16 / React 19

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│    Frontend     │────▶│   Smart Contracts│────▶│  Chainlink DON  │
│   (Next.js)     │     │     (Base)       │     │   (AI Oracle)   │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                        │                        │
        │                        │                        ▼
        ▼                        │               ┌─────────────────┐
┌─────────────────┐              │               │   OpenAI API    │
│   Backend API   │◀─────────────┘               │   (GPT-5.2)     │
│  (AWS Lambda)   │                              └─────────────────┘
└─────────────────┘

Smart Contracts

Two main contracts power Plurimarket:

PredictionMarketFactory

Deploys new prediction market contracts. Stores Chainlink Functions configuration (router, DON ID, subscription).

Base Sepolia: 0xc26554a3e94f09AF2e80Bc863c2d005FF3153c38

PredictionMarket

Individual market contract. Handles YES/NO bets in USDC, triggers AI resolution via Chainlink Functions, and distributes winnings.

Key Functions:

  • • betYes(uint256 amount) - Bet on YES outcome
  • • betNo(uint256 amount) - Bet on NO outcome
  • • requestResolution() - Trigger AI resolution
  • • claim() - Claim winnings after resolution

AI Resolution

When a market's resolution time arrives, anyone can trigger AI resolution. Here's how it works:

  1. 1

    Request Sent to Chainlink

    The contract sends the resolution prompt to Chainlink Functions.

  2. 2

    DON Executes JavaScript

    Chainlink's Decentralized Oracle Network runs JavaScript code that calls OpenAI.

  3. 3

    GPT-5.2 Searches the Web

    The AI model searches for current information and determines YES, NO, or INVALID.

  4. 4

    Result Written On-Chain

    The outcome is recorded in the contract and users can claim their winnings.

What if the AI returns INVALID?

If the AI cannot determine a clear YES or NO answer, the market resolves as INVALID. All participants can reclaim their original bets in full — no one wins or loses.

Creating Markets

Anyone can create a market. Here's what you need:

Market Title

A clear question about a future event.

Example: "Will Bitcoin hit $150k by June 2026?"

Resolution Prompt

Instructions for the AI on how to determine the outcome. Be specific!

Example: "Search for Bitcoin's price history. If BTC reached $150,000 USD at any point before June 30, 2026, return YES. Otherwise, return NO."

Resolution Date

When the AI should evaluate the market. Betting closes at this time.

Pro Tip: Test Your Prompt First

Use the Test Prompt page to see how the AI will resolve your market before creating it.

Placing Bets

All bets are placed in USDC on Base. To place a bet:

  1. 1. Connect your wallet (any wallet via WalletConnect)
  2. 2. Make sure you have USDC on Base
  3. 3. Approve the market contract to spend your USDC
  4. 4. Choose YES or NO and enter your amount
  5. 5. Confirm the transaction

Your potential payout depends on the total pool size and how much is bet on each side. The earlier you bet and the more contrarian your position, the higher your potential return.

Claiming Winnings

After a market resolves, winners can claim their share of the pool:

  • • YES wins: YES bettors split the total pool proportionally
  • • NO wins: NO bettors split the total pool proportionally
  • • INVALID: Everyone can reclaim their original bet amount

Simply click the "Claim" button on the market page after resolution. Your USDC will be sent directly to your wallet.

Open Source

Plurimarket is fully open source. View the code, report issues, or contribute.

View on GitHub