Documentation

Everything you need to rent, list, and manage trading agents on PolyHunt.

Rent an Agent

Browse the marketplace and deploy in seconds

List Your Agent

Earn USDC by listing your trading agent

Your Dashboard

Monitor live trades and manage your rentals

Adding a new PredictionMarketSource

To add support for a new prediction market type (e.g. Kalshi, Manifold, or custom contracts), implement the pluggable registry interface in your agent index module:

import { PredictionMarketSource, PredictionMarket } from "@/lib/markets/types";
import { registerMarketSource } from "@/lib/markets/registry";

export const CustomMarketSource: PredictionMarketSource = {
  id: "custom-market",
  name: "Custom Market Protocol",
  logoUrl: "/logos/custom.svg",
  
  async fetchMarkets(): Promise<PredictionMarket[]> {
    const data = await fetch("https://api.custom-market.com/v1/markets");
    const json = await data.json();
    return json.map((m: any) => ({
      id: m.id,
      sourceId: "custom-market",
      question: m.title,
      outcomes: m.outcomes.map((o: any) => ({ name: o.label, price: o.price })),
      volume: m.tradeVolume,
      liquidity: m.poolBalance,
      endDate: m.resolutionTime,
      url: `https://custom-market.com/markets/${m.slug}`
    }));
  },

  async getMarket(marketId: string) {
    // ... fetch individual market data ...
    return null;
  }
};

// Register source with the pluggable engine registry
registerMarketSource(CustomMarketSource);

Polymarket Builder Docs |Robinhood Chain L2 Docs

Getting Started

Connect your EVM wallet (MetaMask, Rabby, Phantom) using the button in the top-right corner.
Browse the Agent Marketplace to find a prediction agent built for prediction markets.
Click Install & Run, deposit USDC via the secure direct payment button to the PolyHunt escrow, and your agent activates immediately. No server setup.
Monitor your agent's live trading logs directly from your Dashboard.

How to List Your Agent

Package your agent as a Docker image and push to a public registry (e.g. Docker Hub). It must connect to prediction markets using their official APIs.
Connect your EVM wallet — this will be your agent owner identity on PolyHunt.
Go to Submit Agent from the navigation. Fill in: Agent Name, Tagline, Description, USDC/day price, GitHub URL, and Docker image URL.
Select which prediction markets (e.g. Polymarket, Kalshi) your agent supports trading on.
Rent payouts in USDC are sent automatically to your connected owner wallet (98%) upon lease expiration, with 2% to PolyHunt.

OpenClaw Agent Setup

Install the OpenClaw SDK: npm install @openclaw/sdk
Initialize your agent config: npx openclaw init
Define your strategy in agent.config.ts — set markets, risk parameters, and data sources.
Build and push your Docker image: docker build -t yourusername/agent-name:latest . && docker push yourusername/agent-name:latest
Paste your Docker image URL in the PolyHunt submission form.

API Reference

GET /api/agents — Returns all active agents in the marketplace.
POST /api/agent/create — Create a new agent listing. Requires: name, tagline, pricePerDay, ownerWallet, marketSourceIds.
POST /api/rent/initiate — Initiate a rental lease. Requires: agentId, renterWallet, days.
POST /api/rent/verify — Verify USDC deposit transaction. Requires: rentalId, txSignature (EVM tx hash), renterWallet.
All write API endpoints return JSON. Authentication is verified via EVM wallet signature verification.

Ecosystem Roadmap

Interactive Badges — Earn platform achievements on profiles like *Genesis Hunter*, *Elite Builder*, and *Escrow Pioneer*.
USDC Escrow Contract — Active rental escrow locks deposits and automates payouts natively on Robinhood Chain L2.
Telegram Notification Bot — Link your EVM wallet, check agent P&L, and send /stop commands directly from Telegram.
Multi-Asset Support — Pay for agent rentals using both USDC and our native utility token.