curl --request GET \
--url https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions \
--header 'X-Api-Key: <api-key>'import requests
url = "https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"walletAddress": "<string>",
"filter": "open",
"stats": {
"openPositions": {
"value": 123,
"status": "exact"
},
"wonPositions": {
"value": 123,
"status": "exact"
},
"lostPositions": {
"value": 123,
"status": "exact"
},
"voidedPositions": {
"value": 123,
"status": "exact"
},
"redeemablePositions": {
"value": 123,
"status": "exact"
},
"winRate": {
"value": {},
"status": "exact"
},
"totalProfit": {
"value": {},
"status": "exact"
}
},
"positions": [
{
"marketId": "<string>",
"marketSymbol": "<string>",
"marketSlug": "<string>",
"marketTitle": {},
"question": "<string>",
"groupItemTitle": "<string>",
"groupItemImageUrl": "<string>",
"eventId": {},
"eventSlug": "<string>",
"eventTitle": {},
"eventImageUrl": "<string>",
"tags": [
{
"slug": "<string>",
"name": "<string>"
}
],
"marketType": "<string>",
"vertical": "<string>",
"matchId": {},
"matchSlug": "<string>",
"matchTitle": {},
"teamA": {
"code": "<string>",
"label": "<string>",
"logo": "<string>"
},
"teamB": {
"code": "<string>",
"label": "<string>",
"logo": "<string>"
},
"kickoff": {},
"outcome": "<string>",
"outcomeIndex": {},
"outcomeLabel": {},
"negRisk": {
"marketId": "<string>",
"questionIndex": 123
},
"negRiskLinkagePending": true,
"conditionId": "<string>",
"status": "open",
"quantity": {},
"avgCost": {},
"currentPrice": {},
"costBasis": {},
"markValue": {},
"realizedPnl": {},
"unrealizedPnl": {},
"feesPaidUsdc": "<string>",
"feesPaidShares": "<string>",
"feesPaidSharesPrice": "<string>",
"payoutIfCorrect": {},
"redeemable": true,
"redeemed": true,
"payoutPreview": "<string>",
"makeWholeTopup": "<string>",
"pricingStatus": "exact",
"accountingStatus": "exact",
"createdAt": "<string>",
"closesAt": "<string>"
}
],
"nextCursor": "<string>",
"hasMore": true
}Open positions
Returns the wallet’s positions grouped by (market, outcome) with live currentPrice + weighted-average avgCost + realized/unrealized P&L. accountingStatus=unavailable flags positions whose pre-history isn’t fully recoverable (chain re-org, missing trades) — the row is still returned but cost/PnL fields are null. Default filter is open; use all to include resolved (won/lost) positions.
curl --request GET \
--url https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions \
--header 'X-Api-Key: <api-key>'import requests
url = "https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"walletAddress": "<string>",
"filter": "open",
"stats": {
"openPositions": {
"value": 123,
"status": "exact"
},
"wonPositions": {
"value": 123,
"status": "exact"
},
"lostPositions": {
"value": 123,
"status": "exact"
},
"voidedPositions": {
"value": 123,
"status": "exact"
},
"redeemablePositions": {
"value": 123,
"status": "exact"
},
"winRate": {
"value": {},
"status": "exact"
},
"totalProfit": {
"value": {},
"status": "exact"
}
},
"positions": [
{
"marketId": "<string>",
"marketSymbol": "<string>",
"marketSlug": "<string>",
"marketTitle": {},
"question": "<string>",
"groupItemTitle": "<string>",
"groupItemImageUrl": "<string>",
"eventId": {},
"eventSlug": "<string>",
"eventTitle": {},
"eventImageUrl": "<string>",
"tags": [
{
"slug": "<string>",
"name": "<string>"
}
],
"marketType": "<string>",
"vertical": "<string>",
"matchId": {},
"matchSlug": "<string>",
"matchTitle": {},
"teamA": {
"code": "<string>",
"label": "<string>",
"logo": "<string>"
},
"teamB": {
"code": "<string>",
"label": "<string>",
"logo": "<string>"
},
"kickoff": {},
"outcome": "<string>",
"outcomeIndex": {},
"outcomeLabel": {},
"negRisk": {
"marketId": "<string>",
"questionIndex": 123
},
"negRiskLinkagePending": true,
"conditionId": "<string>",
"status": "open",
"quantity": {},
"avgCost": {},
"currentPrice": {},
"costBasis": {},
"markValue": {},
"realizedPnl": {},
"unrealizedPnl": {},
"feesPaidUsdc": "<string>",
"feesPaidShares": "<string>",
"feesPaidSharesPrice": "<string>",
"payoutIfCorrect": {},
"redeemable": true,
"redeemed": true,
"payoutPreview": "<string>",
"makeWholeTopup": "<string>",
"pricingStatus": "exact",
"accountingStatus": "exact",
"createdAt": "<string>",
"closesAt": "<string>"
}
],
"nextCursor": "<string>",
"hasMore": true
}Authorizations
Partner / integrator key — format ps_live_<keyId>_<secret>. Partner keys are issued by PredictStreet; a user can also create keys bound to their own wallet from their account settings in the web app. Never ship to a browser. multi_wallet partners must additionally send X-User-Wallet: 0x<40-hex> on every authenticated request to declare the acting wallet. See the API keys guide for scope taxonomy, partner kinds, rate limits, and rotation procedure.
Headers
Required for multi_wallet partners on every authenticated request; ignored for single_wallet. Declares the acting end-user wallet for this request — drives KYC checks, balances/positions/orders attribution, rate-limit buckets, and audit. Lower-cased server-side. Missing on a multi_wallet key → 401 api_key_user_wallet_required; malformed → 401 api_key_user_wallet_invalid. The on-chain CTFExchange/Vault contracts still verify EIP-712 signer ↔ vault binding, so loosening API-layer attribution is safe by construction.
^0x[a-fA-F0-9]{40}$"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb3"
Query Parameters
open, won, lost, voided, all Page size; omit to receive the full list.
1 <= x <= 50Opaque cursor from a prior nextCursor.
Scope positions to a single market symbol. Pushes the filter into the analytics build (SQL) so an event/market page does not recompute the whole wallet. Combine with status=all to include that market's resolved positions (Claim CTA). Wallet-wide stats (e.g. realizedPnl) are not meaningful when scoped and are reported as zero.
Vertical slug (canonical form, e.g. football) — narrows the position LIST to that vertical only, applied before pagination. Wallet-wide stats stay whole-wallet regardless. 400 invalid_category if the slug cannot round-trip through the canonical vertical vocabulary.
Response
OK
Which slice the positions array was narrowed to — echoes the ?filter= query parameter, defaulting to open.
open, won, lost, voided, all Show child attributes
Show child attributes
Show child attributes
Show child attributes
Opaque cursor for the next page — pass back verbatim as ?cursor=. null when no further pages.
true when there is at least one more page after this one.