Skip to main content
GET
/
v1
/
dflow
/
wallet
/
positions
/
{wallet_address}
Get Dflow Wallet Positions
curl --request GET \
  --url https://api.predexon.com/v1/dflow/wallet/positions/{wallet_address} \
  --header 'x-api-key: <api-key>'
{
  "wallet": "7vfCXTUXx...",
  "positions": [
    {
      "outcome_mint": "8xPqM3...",
      "market_ticker": "BTCPRICE-26JAN",
      "market_title": "Bitcoin above $100k by Jan 2026?",
      "yes_subtitle": "Yes, Bitcoin will be above $100k",
      "no_subtitle": "No, Bitcoin will be at or below $100k",
      "outcome": "yes",
      "status": "open",
      "total_cost_basis": 97.50,
      "avg_entry_price": 0.65,
      "realized_pnl": 0,
      "fees_paid": 1.95,
      "total_qty_bought": 150,
      "total_qty_sold": 0,
      "first_trade_at": 1705420800,
      "last_trade_at": 1705420800
    }
  ],
  "summary": {
    "total_positions": 1,
    "open_positions": 1,
    "closed_positions": 0,
    "total_cost_basis": 97.50,
    "total_realized_pnl": 0,
    "total_fees_paid": 1.95
  },
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 1,
    "has_more": false
  }
}
Fetch positions for a wallet on Dflow. Returns cost basis, realized PnL, and fees. Open positions have total_qty_bought > total_qty_sold. 
{
  "wallet": "7vfCXTUXx...",
  "positions": [
    {
      "outcome_mint": "8xPqM3...",
      "market_ticker": "BTCPRICE-26JAN",
      "market_title": "Bitcoin above $100k by Jan 2026?",
      "yes_subtitle": "Yes, Bitcoin will be above $100k",
      "no_subtitle": "No, Bitcoin will be at or below $100k",
      "outcome": "yes",
      "status": "open",
      "total_cost_basis": 97.50,
      "avg_entry_price": 0.65,
      "realized_pnl": 0,
      "fees_paid": 1.95,
      "total_qty_bought": 150,
      "total_qty_sold": 0,
      "first_trade_at": 1705420800,
      "last_trade_at": 1705420800
    }
  ],
  "summary": {
    "total_positions": 1,
    "open_positions": 1,
    "closed_positions": 0,
    "total_cost_basis": 97.50,
    "total_realized_pnl": 0,
    "total_fees_paid": 1.95
  },
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 1,
    "has_more": false
  }
}

Authorizations

​
x-api-key
string
header
required

API key for authentication. Get your free key at dashboard.predexon.com

Path Parameters

​
wallet_address
string
required

Wallet address to fetch positions for

Query Parameters

​
status
enum<string> | null

Filter by position status: open, closed, or all (default) Dflow position status enum.

Available options:
open,
closed
​
outcome_mint
string | null

Filter by specific outcome mint

​
market_ticker
string | null

Filter by market ticker (case-insensitive)

​
sort_by
enum<string>
default:total_cost_basis

Field to sort by

Available options:
total_qty_bought,
total_cost_basis,
realized_pnl,
fees_paid
​
order
enum<string>
default:desc

Sort order: asc or desc

Available options:
asc,
desc
​
limit
integer
default:100

Maximum number of positions to return

Required range: 1 <= x <= 500
​
offset
integer
default:0

Number of positions to skip for pagination

Required range: x >= 0

Response

Successful Response

Dflow wallet positions endpoint response.

​
wallet
string
required

Wallet address

​
positions
DflowPosition · object[]
required
​
summary
DflowPositionsSummary · object
required

Summary of all dflow positions.

​
pagination
Pagination · object
required

Offset-based pagination model.