> ## Documentation Index
> Fetch the complete documentation index at: https://docs.futuur.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve wager

> Retrieve detailed information about a single wager by its ID.

Retrieve full details for a specific wager, including share count, cost basis, ROI, and resolution status. Public wagers are accessible without authentication.

## Endpoint

```
GET https://api.futuur.com/wagers/{id}/
```

## Authentication

<Note>
  Authentication is optional for this endpoint. Unauthenticated requests can retrieve public wager data. To access private wagers, include the `Key`, `Timestamp`, and `HMAC` headers.
</Note>

## Request

<ParamField path="id" type="integer" required>
  The ID of the wager to retrieve.
</ParamField>

## Response

Returns a `WagerDetail` object. Fields match `WagerList` with the addition of `actions`.

<ResponseField name="id" type="integer" required>
  Unique wager ID.
</ResponseField>

<ResponseField name="status" type="string" required>
  Wager status: `purchased`, `sold`, `won`, `lost`, `cancelled`, or `disabled`.
</ResponseField>

<ResponseField name="status_display" type="string" required>
  Human-readable status label.
</ResponseField>

<ResponseField name="user" type="string" required>
  User resource reference (read-only).
</ResponseField>

<ResponseField name="event" type="string" required>
  Event resource reference (read-only).
</ResponseField>

<ResponseField name="market" type="string" required>
  Market resource reference (read-only).
</ResponseField>

<ResponseField name="position" type="string" required>
  Position direction: `long` (in favor of the outcome) or `short` (against).
</ResponseField>

<ResponseField name="position_display" type="string" required>
  Human-readable position label.
</ResponseField>

<ResponseField name="currency" type="string">
  Currency code for the wager (for example `OOM`, `USDC`).
</ResponseField>

<ResponseField name="shares" type="number" required>
  Consolidated shares held in this wager.
</ResponseField>

<ResponseField name="shares_in_canonical" type="number" required>
  Consolidated shares expressed in the event's canonical currency.
</ResponseField>

<ResponseField name="total_amount" type="string" required>
  Total amount associated with the wager.
</ResponseField>

<ResponseField name="purchases_amount" type="number">
  Cost basis of the open position, adjusted for partial sales.
</ResponseField>

<ResponseField name="active_purchases_amount" type="string" required>
  Amount from active purchases on this wager.
</ResponseField>

<ResponseField name="active_purchases">
  Purchases from the last outcome bought in this event.
</ResponseField>

<ResponseField name="roi" type="string" required>
  Return on investment for the wager.
</ResponseField>

<ResponseField name="earnings" type="string" required>
  Earnings associated with the wager.
</ResponseField>

<ResponseField name="amount_on_win" type="string" required>
  Projected payout if the wager wins.
</ResponseField>

<ResponseField name="amount_on_sell" type="string" required>
  Amount available if the position is sold now.
</ResponseField>

<ResponseField name="last_profit" type="number">
  Last profit when the event resolved or the wager was sold. `null` if not applicable.
</ResponseField>

<ResponseField name="last_sell_amount" type="number">
  Last sale amount when the wager was sold. Always positive when set.
</ResponseField>

<ResponseField name="last_purchase" type="string" required>
  ISO 8601 datetime of the most recent purchase.
</ResponseField>

<ResponseField name="last_update" type="string" required>
  ISO 8601 datetime of the most recent wager update.
</ResponseField>

<ResponseField name="last_action">
  Serialized data about the most recent `WagerAction` on this wager.
</ResponseField>

<ResponseField name="actions_count" type="integer">
  Number of user-triggered actions (purchases, sales) on this wager.
</ResponseField>

<ResponseField name="actions" type="string" required>
  Serialized wager action history (read-only).
</ResponseField>

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url "https://api.futuur.com/wagers/88201/" \
    --header "Key: pk_live_abc123def456" \
    --header "Timestamp: 1712534400" \
    --header "HMAC: 3a9f2c1b...sha512signature"
  ```
</CodeGroup>

```json Sample response theme={null}
{
  "id": 88201,
  "status": "purchased",
  "status_display": "Purchased",
  "user": "https://api.futuur.com/users/5042/",
  "event": "https://api.futuur.com/events/901/",
  "market": "https://api.futuur.com/markets/3801/",
  "position": "long",
  "position_display": "Long",
  "currency": "USDC",
  "shares": 100.0,
  "shares_in_canonical": 100.0,
  "total_amount": "65.00",
  "purchases_amount": 65.0,
  "active_purchases_amount": "65.00",
  "roi": "10.00",
  "earnings": "6.50",
  "amount_on_win": "100.00",
  "amount_on_sell": "71.50",
  "last_profit": null,
  "last_sell_amount": null,
  "last_purchase": "2026-04-05T14:22:10Z",
  "last_update": "2026-04-07T08:15:44Z",
  "last_action": null,
  "actions_count": 1,
  "actions": "https://api.futuur.com/wagers/88201/actions/"
}
```