OpenAPI 3.1

API Plura Market

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

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

GET /v1/public/markets

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

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

GET /v1/public/markets/{marketRef}

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

Повертає публічний market за UUID або slug без приватних 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.
category	category slug	-	Фільтр за категорією ринку.
q	до 100 символів	-	Пошук у назві та описі ринку.

Поля у списку

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

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

Деталі ринку

Detail endpoint додає публічний опис, джерело створення, дані спонсора та metadata публічної FX-серії за їх наявності.

description creationSource sponsor fxFamilyMember

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

{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000104",
      "slug": "will-the-most-popular-market-rank-first",
      "question": "Will the most popular market rank first?",
      "category": "other",
      "categories": ["other"],
      "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, category, q, marketRef або cursor. Cursor прив'язаний до того самого status і sort.

404

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

429

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

API не віддає user IDs, moderation/review fields, приватні orders, стакан, окремі угоди або дані лише для авторизованих користувачів.