Predict API (Beta)
  1. Positions
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
  • Blast
    • Blast multiplier addresses
      GET
  • OAuth
    • Finalize a OAuth connection
    • Get the orders for a OAuth connection
    • Create an order for a OAuth connection
    • Cancel the orders for a OAuth connection
    • Get the positions for a OAuth connection
  • ZeroDev
    • Validate a user op
  1. Positions

Get your positions

GET
/positions
Positions
Get all your positions

Request

Query Params
first
string 
optional
a string that will be parsed into a number
after
string 
optional
a string

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api-sepolia.predict.fun/positions'

Responses

🟢200OK
application/json
Response 200
Body
success
boolean 
required
a boolean
cursor
string  | null 
required
a string
data
array [object {6}] 
required
id
string 
required
a string
market
object 
required
outcome
object 
required
an integer
amount
string 
required
bigint string
valueUsd
string 
required
a string
buyPriceUsd
string 
required
a string
Example
{
  "success": true,
  "cursor": "string",
  "data": [
    {
      "id": "string",
      "market": {
        "id": 0,
        "imageUrl": "string",
        "title": "string",
        "question": "string",
        "description": "string",
        "status": "REGISTERED",
        "isNegRisk": true,
        "feeRateBps": 0,
        "resolution": {
          "name": "string",
          "indexSet": 0,
          "onChainId": "string",
          "status": "WON"
        },
        "oracleQuestionId": "string",
        "conditionId": "string",
        "resolverAddress": "string",
        "outcomes": [
          {
            "name": "string",
            "indexSet": 0,
            "onChainId": "string",
            "status": "WON"
          }
        ],
        "questionIndex": 0,
        "pointAllocationBps": 0,
        "spreadThreshold": 0,
        "shareThreshold": 0,
        "polymarketConditionIds": [
          "string"
        ],
        "categorySlug": "string",
        "createdAt": "string",
        "decimalPrecision": 2
      },
      "outcome": {
        "name": "string",
        "indexSet": 0,
        "onChainId": "string",
        "status": "WON"
      },
      "amount": "string",
      "valueUsd": "string",
      "buyPriceUsd": "string"
    }
  ]
}
Previous
Get market activity
Next
Get leaderboard
Built with