Skip to main content
GET
/
markets
/
closed-positions
Get Closed Positions
curl --request GET \
  --url https://www.aionmarket.com/bvapi/markets/closed-positions \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "message": "success",
  "data": [
    {
      "marketId": "<string>",
      "title": "<string>",
      "outcome": "<string>",
      "size": 123,
      "avgPrice": 123,
      "currentPrice": 123,
      "unrealizedPnl": 123
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.aionmarket.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns positions that have been closed — either because the market resolved or the agent fully exited. The endpoint proxies Polymarket Data API and supports keyword filtering, sorting and pagination.

​
Query Parameters

​
user
string
required
Wallet address used by Polymarket Data API as the user filter.
​
market
string
Market conditionId filter; supports comma-separated values. Mutually exclusive with eventId.
​
title
string
Keyword filter applied to market title. Max 100 chars.
​
limit
integer
default:"10"
Per-page result count (0–50).
​
offset
integer
default:"0"
Pagination offset (0–100000).
​
sortBy
string
default:"REALIZEDPNL"
Sort field. One of REALIZEDPNL, TITLE, PRICE, AVGPRICE, TIMESTAMP.
​
sortDirection
string
default:"DESC"
Sort direction. One of ASC, DESC.
​
venue
string
default:"polymarket"
Trading venue identifier. Default: polymarket.

​
Response

​
data
array
Array of closed positions returned by Polymarket Data API. Common fields include conditionId, tokenId, outcome, size, avgPrice, settlement price and realised PnL.

Authorizations

​
Authorization
string
header
default:YOUR_API_KEY
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
user
string
required

Wallet address (EVM or Solana depending on venue)

​
venue
string
default:polymarket

Trading venue (default: polymarket)

Maximum string length: 50
​
market
string

Market condition ID filter (comma-separated for multiple)

​
title
string

Filter by market title keyword (max 100 chars)

Maximum string length: 100
​
limit
integer
default:10

Results per page (default 10, max 50)

Required range: 0 <= x <= 50
​
offset
integer
default:0

Pagination offset (default 0)

Required range: 0 <= x <= 100000
​
sortBy
enum<string>
default:REALIZEDPNL

Sort field

Available options:
REALIZEDPNL,
TITLE,
PRICE,
AVGPRICE,
TIMESTAMP
​
sortDirection
enum<string>
default:DESC

Sort direction

Available options:
ASC,
DESC

Response

200 - application/json

Closed positions list

​
code
integer
Example:

200

​
message
string
Example:

"success"

​
data
object[]