Markets API

All Markets API endpoints hit the Arc Testnet deployment at https://api.pulsmarket.tech. Data and balances on testnet are not real and may be reset without notice.

Authentication

Endpoint	Auth Required
`GET /api/markets`	No
`GET /api/markets/:slug`	No
`GET /api/markets/:slug/prices`	No
`POST /api/markets/:slug/activate`	Yes — Supabase JWT Bearer token

For authenticated endpoints, include the header:

Authorization: Bearer <SUPABASE_JWT>

List Markets

GET /api/markets

Returns all available prediction markets.

Query Parameters

Parameter	Type	Required	Description
`status`	`string`	No	Filter by market status (`active`, `closed`, `pending`).
`limit`	`number`	No	Maximum number of markets to return. Default `50`.
`offset`	`number`	No	Pagination offset. Default `0`.

Response

{
  "markets": [
    {
      "id": "cm_01abc",
      "slug": "btc-100k-july-2026",
      "title": "Will BTC reach $100k by July 2026?",
      "status": "active",
      "outcomes": ["Yes", "No"],
      "prices": { "Yes": 0.62, "No": 0.38 },
      "volume": 14200.50,
      "liquidity": 8500.00,
      "createdAt": "2026-06-15T12:00:00Z",
      "closesAt": "2026-07-31T23:59:59Z"
    },
    {
      "id": "cm_02def",
      "slug": "eth-merge-v2-q3",
      "title": "Will Ethereum ship Merge v2 in Q3 2026?",
      "status": "active",
      "outcomes": ["Yes", "No"],
      "prices": { "Yes": 0.45, "No": 0.55 },
      "volume": 7300.00,
      "liquidity": 4100.00,
      "createdAt": "2026-06-20T09:30:00Z",
      "closesAt": "2026-09-30T23:59:59Z"
    }
  ],
  "total": 2,
  "limit": 50,
  "offset": 0
}

Get Market Detail

GET /api/markets/:slug

Returns full details for a single market by its slug.

Path Parameters

Parameter	Type	Required	Description
`slug`	`string`	Yes	URL-safe market identifier.

Response

{
  "id": "cm_01abc",
  "slug": "btc-100k-july-2026",
  "title": "Will BTC reach $100k by July 2026?",
  "description": "Resolves Yes if the BTC/USD spot price on any major exchange reaches $100,000 before August 1, 2026.",
  "status": "active",
  "outcomes": ["Yes", "No"],
  "prices": { "Yes": 0.62, "No": 0.38 },
  "volume": 14200.50,
  "liquidity": 8500.00,
  "contractAddress": "0x1a2b3c4d5e6f...",
  "chainId": 2010111,
  "createdAt": "2026-06-15T12:00:00Z",
  "closesAt": "2026-07-31T23:59:59Z"
}

Get Price History

GET /api/markets/:slug/prices

Returns historical price data for a market’s outcomes.

Path Parameters

Parameter	Type	Required	Description
`slug`	`string`	Yes	URL-safe market identifier.

Query Parameters

Parameter	Type	Required	Description
`interval`	`string`	No	Time bucket size: `1h`, `4h`, `1d`. Default `1h`.
`from`	`string`	No	ISO 8601 start timestamp.
`to`	`string`	No	ISO 8601 end timestamp.

Response

{
  "slug": "btc-100k-july-2026",
  "interval": "1h",
  "prices": [
    { "timestamp": "2026-06-28T00:00:00Z", "Yes": 0.58, "No": 0.42 },
    { "timestamp": "2026-06-28T01:00:00Z", "Yes": 0.60, "No": 0.40 },
    { "timestamp": "2026-06-28T02:00:00Z", "Yes": 0.62, "No": 0.38 }
  ]
}

Activate Market (Deploy Contract)

POST /api/markets/:slug/activate

Deploys the on-chain prediction market contract for a pending market. Requires authentication.

Path Parameters

Parameter	Type	Required	Description
`slug`	`string`	Yes	URL-safe market identifier.

Headers

Header	Value
`Authorization`	`Bearer <SUPABASE_JWT>`

Response

{
  "slug": "btc-100k-july-2026",
  "status": "active",
  "contractAddress": "0x1a2b3c4d5e6f...",
  "chainId": 2010111,
  "txHash": "0xabc123..."
}

Error Codes

Status	Description
`401`	Missing or invalid JWT.
`404`	Market not found.
`409`	Market is already activated.

​Authentication

​List Markets

​Query Parameters

​Response

​Get Market Detail

​Path Parameters

​Response

​Get Price History

​Path Parameters

​Query Parameters

​Response

​Activate Market (Deploy Contract)

​Path Parameters

​Headers

​Response

​Error Codes

Authentication

List Markets

Query Parameters

Response

Get Market Detail

Path Parameters

Response

Get Price History

Path Parameters

Query Parameters

Response

Activate Market (Deploy Contract)

Path Parameters

Headers

Response

Error Codes