Get Closed Positions

GET /closed-positions

Get Closed Positions

cURL

curl --request GET \
  --url https://data-api.kuest.com/closed-positions

200

{
  "proxyWallet": "<string>",
  "asset": "<string>",
  "conditionId": "<string>",
  "size": 123,
  "avgPrice": 123,
  "initialValue": 123,
  "currentValue": 123,
  "cashPnl": 123,
  "totalBought": 123,
  "realizedPnl": 123,
  "percentPnl": 123,
  "percentRealizedPnl": 123,
  "curPrice": 123,
  "redeemable": true,
  "mergeable": true,
  "title": "<string>",
  "slug": "<string>",
  "icon": "<string>",
  "eventSlug": "<string>",
  "outcome": "<string>",
  "outcomeIndex": 123,
  "oppositeOutcome": "<string>",
  "oppositeAsset": "<string>",
  "timestamp": 123,
  "endDate": "<string>"
}

Returns cached exits for a wallet with filtering, sorting, and pagination. Use this endpoint to retrieve historical positions that have been fully exited, showing realized profit/loss.

Query Parameters

user · string · required

Wallet address whose closed positions should be returned.

Example: 0x56687bf447db6ffa42ffe2204a05edaa20f55839

market · array

Comma-separated list of condition IDs to filter positions by specific markets.

Example: 0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917

title · string

Substring search against market title (max 100 chars).

limit · integer · default: "10"

Maximum number of rows to return.

Range: 0 to 50

offset · integer · default: "0"

Cursor offset for pagination.

Range: 0 to 100000

sortBy · string · default: "REALIZEDPNL"

Sort column for the response.

Options: REALIZEDPNL, TITLE, PRICE, AVGPRICE, TIMESTAMP

sortDirection · string · default: "DESC"

Sort direction (ascending or descending).

Options: ASC, DESC

Response

Returns an array of closed position objects with the following fields:

proxyWallet · string

The wallet address that held the position.

asset · string

The asset identifier in the format conditionId:outcomeIndex.

conditionId · string

The condition ID (market identifier) for this position.

size · number

Final token balance at the time of exit.

avgPrice · number

Average price paid for this position.

initialValue · number

The initial value invested in this position.

currentValue · number

Current market value (typically 0 for closed positions).

cashPnl · number

Total cash profit/loss realized from this position.

totalBought · number

Total tokens bought for this position.

realizedPnl · number

Realized profit/loss from closing the position.

percentPnl · number

Percentage profit/loss for this position.

percentRealizedPnl · number

Percentage realized profit/loss.

curPrice · number

Current market price for this outcome token.

redeemable · boolean

Whether this position can be redeemed.

mergeable · boolean

Whether this position can be merged.

title · string

The market title/question.

slug · string

URL-friendly market slug.

icon · string

URL to the market icon image.

eventSlug · string

URL-friendly event slug.

outcome · string

The outcome name for this position (e.g., “Yes”, “No”, or candidate name).

outcomeIndex · integer

The numeric index of this outcome.

oppositeOutcome · string

The name of the opposite outcome.

oppositeAsset · string

The asset identifier for the opposite outcome.

timestamp · integer

Unix timestamp when the position was closed.

endDate · string

ISO 8601 date-time when the market closed.

Example Request

cURL

curl -X GET "https://data-api.kuest.com/closed-positions?user=0x56687bf447db6ffa42ffe2204a05edaa20f55839&limit=10&sortBy=REALIZEDPNL&sortDirection=DESC"

Example Response

[
  {
    "proxyWallet": "0x56687bF447db6fFa42FfE2204a05edAa20f55839",
    "asset": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917:0",
    "conditionId": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917",
    "size": 610.2,
    "avgPrice": 0.39,
    "initialValue": 237.98,
    "currentValue": 0,
    "cashPnl": 418.56,
    "totalBought": 1120.4,
    "realizedPnl": 418.56,
    "percentPnl": 37.35,
    "percentRealizedPnl": 37.35,
    "curPrice": 0.68,
    "redeemable": false,
    "mergeable": false,
    "title": "Will the Fed cut rates in September?",
    "slug": "fed-rate-cut-sep-2024",
    "icon": "https://cdn.domain.com/markets/fed.png",
    "eventSlug": "fomc-2024-policy",
    "outcome": "Yes",
    "outcomeIndex": 0,
    "oppositeOutcome": "No",
    "oppositeAsset": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917:1",
    "timestamp": 1718121600,
    "endDate": "2024-09-18T18:00:00Z"
  },
  {
    "proxyWallet": "0x56687bF447db6fFa42FfE2204a05edAa20f55839",
    "asset": "0x8eee3789813eead2d47db3bdf6a1c5021f564ef18e2aefc8b80b9dcd5d6f8ac5:1",
    "conditionId": "0x8eee3789813eead2d47db3bdf6a1c5021f564ef18e2aefc8b80b9dcd5d6f8ac5",
    "size": 980.5,
    "avgPrice": 0.47,
    "initialValue": 460.84,
    "currentValue": 0,
    "cashPnl": 512.91,
    "totalBought": 1685.75,
    "realizedPnl": 512.91,
    "percentPnl": 30.43,
    "percentRealizedPnl": 30.43,
    "curPrice": 0.9,
    "redeemable": false,
    "mergeable": false,
    "title": "Will turnout exceed 60% in the French election?",
    "slug": "france-turnout-60",
    "icon": "https://cdn.domain.com/markets/france-election.png",
    "eventSlug": "french-presidential-2024",
    "outcome": "No",
    "outcomeIndex": 1,
    "oppositeOutcome": "Yes",
    "oppositeAsset": "0x8eee3789813eead2d47db3bdf6a1c5021f564ef18e2aefc8b80b9dcd5d6f8ac5:0",
    "timestamp": 1715668800,
    "endDate": "2024-07-07T20:00:00Z"
  }
]