Predict API (Beta)
    Predict API (Beta)
    • FAQs
    • Guides
      • Understanding the Orderbook
      • How to authenticate your API requests
      • How to create or cancel orders
    • Authorization
      • Get auth message
        GET
      • Get JWT with valid signature
        POST
    • Orders
      • Get order by hash
        GET
      • Get orderbook for specific market
        GET
      • Get orders
        GET
      • Create an order
        POST
      • Optimistically cancel orders
        POST
    • Categories
      • Get categories
        GET
      • Get category by slug
        GET
    • Markets
      • Get markets
        GET
      • Get market statistics
        GET
      • Get market last sale information
        GET
      • Get market activity
        GET
    • Positions
      • Get your positions
        GET
    • Season
      • Get leaderboard
        GET
      • Get season totals
        GET
    • OAuth
      • Finalize a OAuth connection
        POST
      • Get the orders for a OAuth connection
        POST
      • Create an order for a OAuth connection
        POST
      • Cancel the orders for a OAuth connection
        POST
      • Get the positions for a OAuth connection
        POST

    FAQs

    Join our Discord server at https://discord.gg/predictdotfun
    The REST API is currently in beta. Please, report any issue in our Discord server.

    Guides#

    Understanding the Orderbook
    How to authenticate your API requests
    How to create or cancel orders

    Where do I request an API key?#

    To request an API key join the Predict's Discord server and open a support ticket.
    Predict's Discord: https://discord.gg/predictdotfun

    What rate limit is available on mainnet?#

    On Testnet, we allow up to 240 requests per minute without an API key.
    On Mainnet, the default rate limit for an API key is 240 requests per minute.

    What chains are supported?#

    Mainnet (API key required): https://api.predict.fun/
    Testnet (API key not required): https://api-testnet.predict.fun/

    Is there an SDK to create orders?#

    Yes, we have an SDK available as an NPM package: @predictdotfun/sdk
    NPM: https://www.npmjs.com/package/@predictdotfun/sdk
    GitHub: https://github.com/PredictDotFun/sdk

    Can I use my Predict account via the API/SDK?#

    Yes, that is possible. If you are using a EOA (like MetaMask), simply use that wallet as the signer via the SDK to generate the required payloads.
    If you are using a social account via the web app, you will need two things:
    The Predict account address (aka deposit address)
    The Privy Wallet private key (and the address to fund ETH for on-chain tx)
    This can be exported from your account's settings at https://predict.fun/account/settings
    If you use a social accout to interract with Predict, to use your Predict account you'll need our SDK to generate the required signatures. You can check out our guides, which also cover the use of Predict accounts:
    How to authenticate your API requests
    How to create or cancel orders
    Alternatively, you can look into other Account Abstraction SDKs, like ZeroDev SDK. This requires a greater effort on your side and techincal knowledge. We won't be able to provide much support if you choose to use third parties SDKs.

    How do I create orders?#

    See How to create or cancel orders.

    How do I authenticate my requests?#

    See How to authenticate your API requests.

    Is there altervative UI for the API reference?#

    Yes, an alternative UI for the API reference is also available at: https://api.predict.fun/docs
    Modified at 2025-11-07 00:19:53
    Next
    Understanding the Orderbook
    Built with