Skip to main content
BETAThe Prediction Market API is currently in beta and subject to breaking changes as we continue to improve the product. If you have any feedback, please reach out in Discord.
This doc covers how to view your open positions, sell contracts to reduce or exit positions, and cancel pending orders.

​
Prerequisite

Before managing positions, ensure you have:
API REFERENCEFor complete endpoint specifications, see the Prediction API Reference.

​
Viewing Your Positions

See Position Data & History for full details on how to query, filter, and interpret your open positions, including all available parameters and data fields. Example: Fetch all your open positions 
const response = await fetch(
  'https://api.jup.ag/prediction/v1/positions?' + new URLSearchParams({
    ownerPubkey: wallet.publicKey.toString()
  }),
  {
    headers: {
      'x-api-key': 'your-api-key'
    }
  }
);

const positions = await response.json();
console.log(positions);
For descriptions of all position fields, parameters, and how to aggregate P&L, see the Position Data & History doc.All USD values returned are denominated in native token units of JupUSD or USDC, where 1,000,000 units = $1.00.

​
Viewing Your Orders

See Position Data & History for details on available parameters, order fields, and examples. Example: Fetch all your open orders 
const response = await fetch(
  'https://api.jup.ag/prediction/v1/orders?' + new URLSearchParams({
    ownerPubkey: wallet.publicKey.toString()
  }),
  {
    headers: {
      'x-api-key': 'your-api-key'
    }
  }
);

const orders = await response.json();

​
Selling Contracts

You can sell contracts by closing entire position.

​
Close Entire Position

Use DELETE /positions/{positionPubkey} to sell all contracts in a position. 
const positionPubkey = 'position-pubkey-789';

const response = await fetch(
  `https://api.jup.ag/prediction/v1/positions/${positionPubkey}`,
  {
    method: 'DELETE',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'your-api-key'
    },
    body: JSON.stringify({
      ownerPubkey: wallet.publicKey.toString(),
    })
  }
);

const closeResponse = await response.json();
// Sign and submit the transaction (see below)

​
Close All Positions

Use DELETE /positions to close all your open positions at once. This is useful for quickly exiting all markets. 
const response = await fetch('https://api.jup.ag/prediction/v1/positions', {
  method: 'DELETE',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'your-api-key'
  },
  body: JSON.stringify({
    ownerPubkey: wallet.publicKey.toString(),
  })
});

const closeAllResponse = await response.json();
// Sign and submit the transaction (see above)

​
Sign and Submit the Transaction

You’ll receive a base64-encoded transaction. You need to sign and submit it to finalize the position closure on-chain. 
import {
  Connection,
  Keypair,
  VersionedTransaction,
} from '@solana/web3.js';
import fs from 'fs';

// Setup connection and wallet
const connection = new Connection('YOUR_RPC_URL');
const privateKey = JSON.parse(fs.readFileSync('/path/to/wallet.json', 'utf8'));
const wallet = Keypair.fromSecretKey(new Uint8Array(privateKey));

// Step 1: Initiate closing a position
const positionPubkey = 'YOUR_POSITION_PUBKEY';

const response = await fetch(
  `https://api.jup.ag/prediction/v1/positions/${positionPubkey}`,
  {
    method: 'DELETE',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'your-api-key'
    },
    body: JSON.stringify({
      ownerPubkey: wallet.publicKey.toString(),
    })
  }
);

const closeResponse = await response.json();
const base64Txn = closeResponse.transaction;

// Step 2: Deserialize and sign transaction
const transaction = VersionedTransaction.deserialize(
  Buffer.from(base64Txn, 'base64')
);
transaction.sign([wallet]);

const transactionBinary = transaction.serialize();
const blockhashInfo = await connection.getLatestBlockhashAndContext({ commitment: "confirmed" });

// Step 3: Send the transaction and await status
const signature = await connection.sendRawTransaction(transactionBinary, {
  maxRetries: 0,
  skipPreflight: true,
  preflightCommitment: "confirmed",
});

console.log(`Transaction sent: https://solscan.io/tx/${signature}`);

try {
  const confirmation = await connection.confirmTransaction({
    signature,
    blockhash: blockhashInfo.value.blockhash,
    lastValidBlockHeight: blockhashInfo.value.lastValidBlockHeight,
  }, "confirmed");

  if (confirmation.value.err) {
    console.error(`Transaction failed: ${JSON.stringify(confirmation.value.err)}`);
    console.log(`Examine the failed transaction: https://solscan.io/tx/${signature}`);
  } else {
    console.log(`Position closed successfully: https://solscan.io/tx/${signature}`);
  }
} catch (error) {
  console.error(`Error confirming transaction: ${error}`);
  console.log(`Examine the transaction status: https://solscan.io/tx/${signature}`);
}

​
What’s Next

Learn how to claim payouts when markets settle in your favor, or explore the data endpoints for tracking your activity.

Claim Payouts

Claim winnings after market settlement

Position Data & History

Query positions, orders, and transaction history