OpenAPI 3.1

API Plura Market

Публічний REST API для читання ринків Plura Market без авторизації. Він віддає тільки відкриті дані: список активних і архівних ринків, деталізацію ринку, стакан, останні угоди та історію ймовірності.

Скачати OpenAPI YAML Відкрити файл

GET /v1/public/markets

Список публічних ринків

Повертає approved/listed ринки з фільтрами за статусом, сортуванням і cursor pagination.

GET /v1/public/markets/{marketId}

Деталі одного ринку

Повертає market, orderBook, recentFills і probHistory без приватних user/admin/premium полів.

GET /v1/public/markets/snapshot

Короткий public snapshot

Повертає freshMarkets і closingSoonMarkets для публічних блоків на сайті.

Швидкий старт

Усі публічні методи працюють без Bearer token і без API key. Production base URL: https://pluramarket.com.

Отримати список активних ринків

curl "https://pluramarket.com/v1/public/markets?status=open&sort=popular&limit=20"

Отримати один ринок по ID

curl "https://pluramarket.com/v1/public/markets/00000000-0000-0000-0000-000000000102"

Параметри списку

Параметр	Значення	Default	Опис
status	open, archive, closed, resolved, cancelled, all	open	Фільтр життєвого циклу. archive включає closed, resolved і cancelled.
sort	popular, activity, volume, new, ended	popular / ended	popular для open/all за замовчуванням; ended для архівних статусів.
limit	1..100	20	Розмір сторінки.
cursor	opaque string	-	Cursor з nextCursor. Використовуйте з тим самим status і sort.

Поля у списку

`GET /v1/public/markets` повертає `items` і `nextCursor`. Кожен item має тільки публічні ринкові поля.

id question status prob volume closeTime resolution createdAt resolvedAt lastActivityAt traderCount fills24h acceptingBets

Деталі ринку

Detail endpoint додає опис, CPMM pools, FX metadata, стакан, останні fills і історію ймовірності.

description poolYes poolNo tradingPauseReason fxFamilyMember orderBook recentFills probHistory

Приклад відповіді списку

{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000104",
      "question": "Will the most popular market rank first?",
      "status": "open",
      "prob": 0.48,
      "volume": 180,
      "closeTime": "2026-06-05T12:00:00.000Z",
      "resolution": null,
      "createdAt": "2026-05-24T12:00:00.000Z",
      "resolvedAt": null,
      "lastActivityAt": "2026-05-30T11:05:00.000Z",
      "traderCount": 3,
      "fills24h": 2,
      "acceptingBets": true
    }
  ],
  "nextCursor": null
}

Помилки та приватність

400

Некоректний status, sort, limit або cursor. Cursor прив'язаний до того самого status і sort.

404

Ринок не існує або не є публічним: hidden, pending, rejected і non-public markets не розкриваються.

429

Перевищено rate limit. Не обходьте ліміти паралельними IP або агресивним polling.

API не віддає user IDs, moderation/review fields, приватні orders, `myOpenOrders`, matched bet IDs або premium-only top forecaster data.