curl --request POST \
--url https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions/redeem \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"marketId": "PM-WC26-R16-USA-WC26-1910V2",
"outcomeIndex": 0
}
'import requests
url = "https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions/redeem"
payload = {
"marketId": "PM-WC26-R16-USA-WC26-1910V2",
"outcomeIndex": 0
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({marketId: 'PM-WC26-R16-USA-WC26-1910V2', outcomeIndex: 0})
};
fetch('https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions/redeem', 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/redeem",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'marketId' => 'PM-WC26-R16-USA-WC26-1910V2',
'outcomeIndex' => 0
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions/redeem"
payload := strings.NewReader("{\n \"marketId\": \"PM-WC26-R16-USA-WC26-1910V2\",\n \"outcomeIndex\": 0\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions/redeem")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"marketId\": \"PM-WC26-R16-USA-WC26-1910V2\",\n \"outcomeIndex\": 0\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions/redeem")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"marketId\": \"PM-WC26-R16-USA-WC26-1910V2\",\n \"outcomeIndex\": 0\n}"
response = http.request(request)
puts response.read_body{
"jobId": "4210",
"status": "pending"
}Claim a settled position without paying gas
Queues a gasless redemption that the platform broadcasts on the user’s behalf. The user identifies the position by (marketId, outcomeIndex); the server reads the position, verifies it is redeemable, builds the on-chain payload (binary conditionId+indexSets or neg-risk marketId+questionIndex+amount), and queues the job. Returns { jobId, status }; poll GET /api/me/positions/redeem/:jobId until the job confirms.
Failures: 400 not_redeemable / neg_risk_not_ready / no_quantity / no_condition_id; 403 no_vault; 404 position_not_found.
curl --request POST \
--url https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions/redeem \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"marketId": "PM-WC26-R16-USA-WC26-1910V2",
"outcomeIndex": 0
}
'import requests
url = "https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions/redeem"
payload = {
"marketId": "PM-WC26-R16-USA-WC26-1910V2",
"outcomeIndex": 0
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({marketId: 'PM-WC26-R16-USA-WC26-1910V2', outcomeIndex: 0})
};
fetch('https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions/redeem', 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/redeem",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'marketId' => 'PM-WC26-R16-USA-WC26-1910V2',
'outcomeIndex' => 0
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions/redeem"
payload := strings.NewReader("{\n \"marketId\": \"PM-WC26-R16-USA-WC26-1910V2\",\n \"outcomeIndex\": 0\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions/redeem")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"marketId\": \"PM-WC26-R16-USA-WC26-1910V2\",\n \"outcomeIndex\": 0\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://core.api.dev.predictstreet.sde.adifoundation.ai/api/me/positions/redeem")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"marketId\": \"PM-WC26-R16-USA-WC26-1910V2\",\n \"outcomeIndex\": 0\n}"
response = http.request(request)
puts response.read_body{
"jobId": "4210",
"status": "pending"
}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"
Body
Market identifier of the position to redeem — the marketId field from the Position payload (GET /api/me/positions).
1 - 128"PM-WC26-R16-USA-WC26-1910V2"
Outcome index of the held position (0 = YES, 1 = NO). For binary markets this scopes the CTF indexSets bitmask to the single side the user holds; for neg-risk it only disambiguates which Position row to read (the adapter burns both sides in one call regardless).
0 <= x <= 2550
Owner-signed RedeemAuthorization. REQUIRED for API-key (partner) callers; IGNORED for web-app session (retail) callers (the session binds the wallet already). See RedeemAuthDto.
Show child attributes
Show child attributes