Predict API (Beta)
  1. Accounts
  • FAQs
  • Deployed Contracts
  • Guides
    • Understanding the Orderbook
    • [TS] How to authenticate your API requests
    • [PY] How to authenticate your API requests
    • How to create or cancel orders
  • WebSocket
    • General Information
    • Request Format
    • Response Format
    • Subscription Topics
    • Heartbeats
    • Client Example
  • Authorization
    • Get auth message
      GET
    • Get JWT with valid signature
      POST
  • Categories
    • Get categories
      GET
    • Get category by slug
      GET
    • Get all tags
      GET
  • Markets
    • Get markets
      GET
    • Get market by ID
      GET
    • Get market statistics
      GET
    • Get market last sale information
      GET
    • Get the orderbook for a market
      GET
    • Get market timeseries
      GET
    • Get latest market timeseries value
      GET
  • Orders
    • Get order by hash
      GET
    • Get orders
      GET
    • Get order match events
      GET
    • Remove orders from the orderbook
      POST
    • Create an order
      POST
    • Remove orders by hash
      POST
  • Accounts
    • Get connected account
      GET
    • Get account activity
      GET
    • Get PnL history by address
      GET
    • Set a referral
      POST
  • Positions
    • Get positions
      GET
    • Get positions by address
      GET
  • Activity
    • Join an activity
    • Get activity registration
  • Search
    • Search categories and markets
      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
  • Schemas
    • AccountData
    • PositionData
    • ActivityRegistrationResponse
    • ActivityRegistration
    • PnlPeriod
    • AccountResponse
    • TagsResponse
    • PnlPoint
    • ActivityEvent
    • WalletPnlData
    • ActivityEventName
    • WalletPnlResponse
    • ActivityOrderData
    • ActivityResponse
    • AuthMessageData
    • AuthMessageResponse
    • AuthTokenData
    • AuthTokenResponse
    • BulletinBoardUpdate
    • CategoryWithStats
    • BulletinBoardUpdatesResponse
    • CryptoCategoryDetails
    • CategoryResponse
    • SportsCategoryDetails
    • CategorySort
    • CategoryStatsData
    • CategoryStatsResponse
    • CategoryStatus
    • CategoryStatusFilter
    • CategoriesResponse
    • ContractOrder
    • CreateOrderData
    • CreateOrderRequest
    • CreateOrderResponse
    • Fee
    • FeeEventData
    • FeeEventsResponse
    • CategoryVariantDetails
    • FeeType
    • LastOrderSettled
    • LastSaleData
    • LastSaleResponse
    • MarketResponse
    • MarketRewards
    • MarketSort
    • MarketStatsData
    • CreateOrderResponseData
    • MarketStatsResponse
    • OAuthCancelOrdersData
    • MarketStatus
    • OAuthCancelOrdersRequest
    • CryptoUpDownVariantData
    • MarketStatusFilter
    • OAuthCancelOrdersResponse
    • ErrorCode
    • OAuthCreateOrderData
    • MarketTimeseries
    • ErrorResponse
    • OAuthCreateOrderRequest
    • MarketTimeseriesLatest
    • MarketTradingStatus
    • OAuthCreateOrderResponse
    • EsportsVariantData
    • OAuthFinalizeData
    • OAuthFinalizeRequest
    • OAuthFinalizeResponse
    • OAuthOrdersData
    • OAuthOrdersRequest
    • MatchData
    • OAuthOrdersResponse
    • MatchesResponse
    • OAuthPositionsData
    • Metric
    • OAuthPositionsRequest
    • OAuthPositionsResponse
    • OrderData
    • OrderResponse
    • OrderStatus
    • OrderStrategy
    • LeaderboardEntry
    • OrderbookData
    • LeaderboardResponse
    • OrderbookResponse
    • Market
    • OrdersResponse
    • OutcomeStatus
    • PendingYieldData
    • PendingYieldResponse
    • PointsInfo
    • PositionSort
    • MarketType
    • MarketVariant
    • PositionsResponse
    • PostAuthRequest
    • MarketVariantDetails
    • PriceFeedProvider
    • RemoveOrdersRequest
    • MarketWithStats
    • MarketsResponse
    • PriceLevel
    • ReferralInfo
    • ReferralStatus
    • RemoveOrdersByHashData
    • RemoveOrdersByHashRequest
    • Resolution
    • RewardPeriod
    • SearchData
    • SearchResponse
    • SelfTradePreventionStrategy
    • SetReferralData
    • SetReferralRequest
    • SetReferralResponse
    • SportsEventTeam
    • SportsFifaFriendliesVariantData
    • OracleUpdate
    • SportsFifaWorldCupVariantData
    • OracleUpdatesResponse
    • SportsNbaVariantData
    • OrderFillData
    • SportsPropsMarketData
    • SportsTeamOutcomeData
    • OrderStatusFilter
    • Team
    • TeamSide
    • TimeseriesData
    • TimeseriesLatestData
    • Outcome
    • TimeseriesLatestResponse
    • OutcomeSide
    • TimeseriesPoint
    • TimeseriesResponse
    • TweetCountVariantData
    • OutcomeVariantData
    • VariantData_CryptoUpDownVariantData
    • OutcomeVariantData_SportsTeamOutcomeData
    • VariantData_SportsFifaFriendliesVariantData
    • OutcomeVariantDetails
    • VariantData_SportsFifaWorldCupVariantData
    • VariantData_SportsNbaVariantData
    • VariantData_SportsPropsMarketData
    • VariantData_TweetCountVariantData
    • QuoteType
    • RemoveOrdersData
    • RemoveOrdersResponse
    • ResolutionProvider
    • SelectTeamsRequest
    • SportsDataProvider
    • SportsMarketDetails
    • SportsOutcomeDetails
    • Tag
    • TweetCategoryDetails
    • VariantData
    • VariantData_EsportsVariantData
  1. Accounts

Get PnL history by address

Prod Env
https://api.predict.fun
Prod Env
https://api.predict.fun
GET
https://api.predict.fun
/v1/account/{address}/pnl
Cumulative profit and loss in USD for any wallet, the series the
predict.fun profile chart shows. period picks the window and with it
the spacing: hourly points for 1d, daily for 7d and 30d, and the
whole history for all (the default). The latest point is the current
PnL.
The whole series comes back in one response, so there is no cursor.
Results are cached for up to 30 seconds, so polling faster than that
returns the same series. An address with no account returns an empty
series.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Path Params

Query Params

Responses

🟢200
application/json; charset=utf-8
Bodyapplication/json; charset=utf-8

🟠400
🟠401
🟠403
🟠404
🟠410
🟠429
🔴500
🔴502
🔴503
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.predict.fun/v1/account//pnl?period=' \
--header 'x-api-key: <api-key>'
Response Response Example
200 - Example 1
{
    "success": true,
    "data": {
        "period": "1d",
        "points": [
            {
                "x": 0,
                "y": 0
            }
        ]
    }
}
Modified at 2026-10-26 17:28:36
Previous
Get account activity
Next
Set a referral
Built with