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

# Disputes

> REST endpoints for querying dispute data.

## List Disputes

Retrieve a list of all disputes.

```
GET /disputes
```

**status** `string`

Filter by status: `voting`, `active`, `resolved`, `expired`.

**limit** `integer` (default: 100)

Number of disputes to return.

**offset** `integer` (default: 0)

Offset for pagination.

```bash cURL theme={"dark"}
curl "https://api.orica.markets/disputes?status=voting"
```

```typescript TypeScript theme={"dark"}
const response = await fetch(
  "https://api.orica.markets/disputes?status=voting"
);
const disputes = await response.json();
```

### Response

```json theme={"dark"}
[
  {
    "market_address": "ABC123...",
    "status": "voting",
    "opened_at": 1704067200,
    "total_pool_weight": 15000000000,
    "votes_for_dispute": 8500000000,
    "vote_percentage": 56.67,
    "message_count": 12,
    "resolved_by": null,
    "final_outcome": null,
    "resolution_metadata_uri": null,
    "resolved_at": null,
    "created_at": 1704067200,
    "activated_at": 1704153600
  }
]
```

***

## Get Dispute

Retrieve details for a specific dispute.

```
GET /disputes/{market_address}
```

**market\_address** `string` *required*

The market address associated with the dispute.

### Response Fields

**market\_address** `string`

The market being disputed.

**status** `string`

Current status: `voting`, `active`, `resolved`, `expired`.

**opened\_at** `number`

Unix timestamp when dispute was created.

**total\_pool\_weight** `number`

Total staked weight in the pool (base units).

**votes\_for\_dispute** `number`

Weight voting to overturn resolution.

**vote\_percentage** `number`

Percentage of votes for the dispute.

**message\_count** `number`

Number of discussion messages.

**activated\_at** `number`

When the dispute threshold was met (>50% votes).

***

## Get Dispute Votes

Retrieve all votes for a dispute.

```
GET /disputes/{market_address}/votes
```

**market\_address** `string` *required*

The market address.

### Response

```json theme={"dark"}
{
  "total_votes": 42,
  "total_weight": 15000000000,
  "votes": [
    {
      "market_address": "ABC123...",
      "user_address": "User456...",
      "weight": 5000000000,
      "weight_usdc": 5000.00,
      "timestamp": 1704067200,
      "signature": "5K7x..."
    }
  ]
}
```

***

## Get Dispute Messages

Retrieve discussion messages for a dispute.

```
GET /disputes/{market_address}/messages
```

**market\_address** `string` *required*

The market address.

**sort\_by** `string` (default: weight)

Sort criteria: `weight` or `timestamp`.

### Response

```json theme={"dark"}
[
  {
    "pubkey": "Msg123...",
    "market_address": "ABC123...",
    "author": "User456...",
    "parent_message": null,
    "content": "The resolution is incorrect because...",
    "author_weight": 5000000000,
    "boost_amount": 2000000000,
    "total_weight": 7000000000,
    "is_admin": false,
    "timestamp": 1704067200,
    "message_index": 0
  }
]
```

***

## Get Message Boosts

Retrieve boosts for a specific message.

```
GET /disputes/{market_address}/messages/{message_pubkey}/boosts
```

### Response

```json theme={"dark"}
{
  "total_boosts": 5,
  "total_amount": 2000000000,
  "boosts": [
    {
      "message_pubkey": "Msg123...",
      "market_address": "ABC123...",
      "booster": "User789...",
      "amount": 500000000,
      "amount_usdc": 500.00,
      "timestamp": 1704153600
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.