Selling a position

Selling a position means placing an ask (sell) order on a market where you already hold shares. You can sell your entire position to exit completely, or sell a portion to reduce your exposure.

All examples use https://api.futuur.com/v2.0. Every request requires HMAC authentication headers. See the Authentication guide for how to generate them.

List your active wagers

Call GET /wagers/ to see all positions you currently hold. Filter by active=true to show only open wagers.

import requests

response = requests.get(
    "https://api.futuur.com/v2.0/wagers/",
    params={"active": True},
    headers={
        "Key": "YOUR_PUBLIC_KEY",
        "Timestamp": "1712500000",
        "HMAC": "YOUR_HMAC_SIGNATURE",
    },
)

wagers = response.json()["results"]
for wager in wagers:
    print(
        f"Wager {wager['id']} — Market: {wager['market']}, "
        f"Shares: {wager['shares']}, Position: {wager['position']}"
    )

curl -G "https://api.futuur.com/v2.0/wagers/" \
  --data-urlencode "active=true" \
  -H "Key: YOUR_PUBLIC_KEY" \
  -H "Timestamp: 1712500000" \
  -H "HMAC: YOUR_HMAC_SIGNATURE"

The response includes each wager’s market ID, the number of shares you hold, and the position (long or short).

Find the wager you want to exit

Identify the wager you want to sell. Note the following fields from the wager response:

market — the market ID you’ll use in the sell order
shares — the total number of shares you hold (your maximum sell quantity)
position — long if you bet the outcome happens, short if you bet against it
currency — the currency the wager was placed in

python

# Pick the wager you want to exit
target_wager = wagers[0]

market_id = target_wager["market"]
shares_held = target_wager["shares"]
position = target_wager["position"]
currency = target_wager["currency"]

print(f"Selling {shares_held} shares on market {market_id} ({position} position)")

To check the current sell price before committing, fetch the order book with GET /markets/{id}/book/ and look at the bid array. The highest bid is the best price you can sell at. See Reading the order book.

Place an ask (sell) order

To sell, place a POST /orders/ request with side="ask". Match the position field to the position type you hold — long for long shares, short for short shares.Use shares to specify exactly how many shares to sell. Set price=null for a market sell (executes immediately at the best available bid), or set a specific price to place a limit sell.Market sell (sell immediately):

# Sell all shares immediately at the best available price
response = requests.post(
    "https://api.futuur.com/v2.0/orders/",
    json={
        "market": market_id,
        "side": "ask",
        "currency": currency,
        "position": position,
        "shares": shares_held,
        "price": None,
    },
    headers={
        "Key": "YOUR_PUBLIC_KEY",
        "Timestamp": "1712500000",
        "HMAC": "YOUR_HMAC_SIGNATURE",
        "Content-Type": "application/json",
    },
)

order = response.json()
print("Sell order ID:", order["id"], "Status:", order["status"])

# Sell all shares immediately at the best available price
curl -X POST "https://api.futuur.com/v2.0/orders/" \
  -H "Key: YOUR_PUBLIC_KEY" \
  -H "Timestamp: 1712500000" \
  -H "HMAC: YOUR_HMAC_SIGNATURE" \
  -H "Content-Type: application/json" \
  -d '{
    "market": 67890,
    "side": "ask",
    "currency": "OOM",
    "position": "long",
    "shares": 150.0,
    "price": null
  }'

Limit sell (only fill at your target price or better):

# Limit sell: only sell if the price reaches 0.70 or higher
response = requests.post(
    "https://api.futuur.com/v2.0/orders/",
    json={
        "market": market_id,
        "side": "ask",
        "currency": currency,
        "position": position,
        "shares": shares_held,
        "price": 0.70,
    },
    headers={
        "Key": "YOUR_PUBLIC_KEY",
        "Timestamp": "1712500000",
        "HMAC": "YOUR_HMAC_SIGNATURE",
        "Content-Type": "application/json",
    },
)

order = response.json()
print("Limit sell order placed. ID:", order["id"])

# Limit sell: only sell if the price reaches 0.70 or higher
curl -X POST "https://api.futuur.com/v2.0/orders/" \
  -H "Key: YOUR_PUBLIC_KEY" \
  -H "Timestamp: 1712500000" \
  -H "HMAC: YOUR_HMAC_SIGNATURE" \
  -H "Content-Type: application/json" \
  -d '{
    "market": 67890,
    "side": "ask",
    "currency": "OOM",
    "position": "long",
    "shares": 150.0,
    "price": 0.70
  }'

Confirm the order is filled and the wager is closed

Check the order’s status in the response. For market sells, the status is typically filled immediately. For limit sells, it remains open until a buyer matches your price.

python

order = response.json()

if order["status"] == "filled":
    print("Position closed. Proceeds:", order["amount"])
elif order["status"] == "open":
    print("Limit sell is open. Waiting for price:", order["price"])

To confirm the wager is fully closed, re-fetch your wagers list. A fully sold wager will no longer appear in the active=true results.

response = requests.get(
    "https://api.futuur.com/v2.0/wagers/",
    params={"active": True},
    headers={
        "Key": "YOUR_PUBLIC_KEY",
        "Timestamp": "1712500000",
        "HMAC": "YOUR_HMAC_SIGNATURE",
    },
)

active_ids = [w["id"] for w in response.json()["results"]]
if target_wager["id"] not in active_ids:
    print("Wager is fully closed.")
else:
    print("Wager is still open (partial fill or limit order pending).")

curl -G "https://api.futuur.com/v2.0/wagers/" \
  --data-urlencode "active=true" \
  -H "Key: YOUR_PUBLIC_KEY" \
  -H "Timestamp: 1712500000" \
  -H "HMAC: YOUR_HMAC_SIGNATURE"

Partial sells

You don’t have to sell your entire position at once. Pass a shares value smaller than your total holding to partially exit. The remaining shares stay open in your wager.

python

# Sell only half your shares
shares_to_sell = shares_held / 2

response = requests.post(
    "https://api.futuur.com/v2.0/orders/",
    json={
        "market": market_id,
        "side": "ask",
        "currency": currency,
        "position": position,
        "shares": shares_to_sell,
        "price": None,
    },
    headers={
        "Key": "YOUR_PUBLIC_KEY",
        "Timestamp": "1712500000",
        "HMAC": "YOUR_HMAC_SIGNATURE",
        "Content-Type": "application/json",
    },
)

After a partial fill, your wager’s shares field decreases by the number of shares sold.

Long vs short positions

Position	What it means	How to sell
Long (`"long"`)	You bet the outcome happens	Place `side="ask"`, `position="long"`
Short (`"short"`)	You bet the outcome does not happen	Place `side="ask"`, `position="short"`

Always match the position field in your sell order to the position type you hold. Mismatching will result in an error or an unintended new position.

Cancelling an unfilled limit sell

If your limit sell order hasn’t filled yet and you want to cancel it, use PATCH /orders/{id}/cancel/:

order_id = order["id"]

response = requests.patch(
    f"https://api.futuur.com/v2.0/orders/{order_id}/cancel/",
    headers={
        "Key": "YOUR_PUBLIC_KEY",
        "Timestamp": "1712500000",
        "HMAC": "YOUR_HMAC_SIGNATURE",
    },
)

print("Cancelled:", response.status_code == 204)

curl -X PATCH "https://api.futuur.com/v2.0/orders/99999/cancel/" \
  -H "Key: YOUR_PUBLIC_KEY" \
  -H "Timestamp: 1712500000" \
  -H "HMAC: YOUR_HMAC_SIGNATURE"

Get Started

Core Concepts

Guides

Partial sells

Long vs short positions

Cancelling an unfilled limit sell

​Partial sells

​Long vs short positions

​Cancelling an unfilled limit sell

Partial sells

Long vs short positions

Cancelling an unfilled limit sell