> ## 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.

# Markets

> REST endpoints for querying market data.

## List Markets

Retrieve a paginated list of all markets.

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

Number of markets to return (max 1000).

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

Offset for pagination.

```bash cURL theme={"dark"}
curl "https://api.orica.markets/markets?limit=50&offset=0"
```

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

### Response

```json theme={"dark"}
[
  {
    "address": "ABC123...",
    "question": "Will Bitcoin hit $100k by 2025?",
    "options": ["Yes", "No"],
    "creator": "Creator123...",
    "created_at": 1704067200,
    "close_time": 1735689600,
    "status": "open",
    "outcome_pools": [1500000000, 2000000000],
    "outcome_supplies": [15000, 20000],
    "total_volume": 35000.50,
    "trade_count": 142,
    "metadata_uri": "ipfs://Qm...",
    "image_url": "https://ipfs.io/ipfs/Qm...",
    "resolution_outcome": null,
    "resolution_metadata_uri": null,
    "resolved_at": null,
    "resolver": null
  }
]
```

### Response Fields

**address** `string`

The on-chain address of the market account.

**question** `string`

The question being asked.

**options** `string[]`

List of possible outcomes.

**creator** `string`

Wallet address of the market creator.

**created\_at** `number`

Unix timestamp of market creation.

**close\_time** `number`

Unix timestamp when trading ends.

**status** `string`

Current status: `open`, `closed`, `resolved`, or `disputed`.

**outcome\_pools** `number[]`

USDC liquidity in each outcome's pool (in base units).

**outcome\_supplies** `number[]`

Number of shares minted for each outcome.

**total\_volume** `number`

Total USDC volume traded (in USDC, not base units).

**trade\_count** `number`

Number of trades executed.

**metadata\_uri** `string`

IPFS URI for market metadata.

**image\_url** `string`

Direct URL to market image (if available).

**resolution\_outcome** `number`

Winning outcome index (null if not resolved, 255 for unresolvable).

**resolution\_metadata\_uri** `string`

IPFS URI for resolution evidence.

**resolved\_at** `number`

Unix timestamp of resolution.

**resolver** `string`

Wallet address of the resolver.

***

## Status Computation

The API dynamically computes market status:

| On-chain Status | Current Time vs Close Time | Returned Status |
| - | - | - |
| `open` | Before close\_time | `open` |
| `open` | After close\_time | `closed` |
| `resolved` | - | `resolved` |
| `disputed` | - | `disputed` |

> [!NOTE]
>
> Blockchain time is used for status computation, not server time.


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