---
title: "Get all markets"
method: GET
path: "/api/v1/markets"
tags: ["get-all-markets"]
---

# Get all markets

`GET /api/v1/markets`

Returns a paginated list of all markets available on 42. Supports rich filtering by status, category, collateral, volume range, date range, and tags. Use `order` + `ascending` to control sort direction.

## Query parameters

- `limit` integer
- `offset` integer
- `order` string
- `ascending` boolean
- `question_id` string
- `market_address` string
- `collateral` string
- `status` string
- `volume_min` number
- `volume_max` number
- `start_date_min` string
- `start_date_max` string
- `end_date_min` string
- `end_date_max` string
- `tag` string
- `category` string
- `subcategory` string
- `topic` string
- `oracle` string
- `creator` string
- `contract_version` integer
- `locale` string
- `fields` string

## Response `200`

OK

- FtMarketServiceV2PkgApiPaginatedResponseInternalHandlerMarketResponse
  - `data` InternalHandlerMarketResponse[]
    - `address` string
    - `ancillaryData` string[] — Ancillary metadata entries posted on-chain by the question creator, oldest-first. Each entry is a comma-separated "key:value" pair list with `\,`, `\:`, and `\\` as escapes. Empty array for legacy markets. Always the raw on-chain form; translated human-readable bodies surface inside `translation.ancillary` (parallel array, same indexing).
    - `availableLocales` string[] — Locales with an approved translation. Lets clients build a language switcher. Empty array when none. The internal pipeline status is intentionally not exposed.
    - `backgroundImage` string — Admin-set background image for the market's grid card (off-chain metadata only). Null when unset.
    - `categories` string[]
    - `collateralAddress` string
    - `collateralDecimals` integer
    - `collateralSymbol` string
    - `contractVersion` integer — On-chain contract version that produced this market (1 = legacy, 2 = v2).
    - `createdAt` string
    - `creator` InternalHandlerAddressInfoResponse
      - `address` string
      - `image` string
      - `name` string
    - `curve` string
    - `description` string — Deprecated: populated from on-chain metadata for legacy v1 markets. For v2 markets, use AncillaryData — the first entry carries the creator's metadata including a `description` key.
    - `elapsedPct` number
    - `endDate` string
    - `feeRate` number
    - `finalisedAt` string
    - `image` string
    - `isFlagged` boolean — True when the question currently has an active creator-issued flag whose expiry (if any) is in the future.
    - `oracle` InternalHandlerAddressInfoResponse
      - `address` string
      - `image` string
      - `name` string
    - `outcomes` InternalHandlerOutcomeResponse[]
      - `holdersAtFinalisation` integer
      - `image` string
      - `index` integer
      - `marketCap` number
      - `mintedQuantity` number
      - `name` string
      - `payout` number
      - `price` number
      - `symbol` string
      - `tokenId` string
      - `translation` InternalHandlerOutcomeTranslation — Localized outcome text for the requested locale.
        - `name` string
      - `volume` number
    - `proposer` InternalHandlerProposerResponse — Deprecated: proposer metadata. Not translated. Will be removed in a future release.
      - `image` string
      - `name` string
    - `question` string
    - `questionId` string
    - `resolutionTime` string
    - `resolvedAnswer` string
    - `slug` string
    - `sourceLocale` string — Source locale of the on-chain `question`/`ancillaryData` fields (defaults to "en").
    - `startDate` string
    - `status` string
    - `subcategories` string[]
    - `tags` string[]
    - `topics` string[]
    - `totalMarketCap` number
    - `traders` integer
    - `translation` InternalHandlerMarketTranslation — Localized market text for the requested locale.
      - `ancillary` string[]
      - `title` string
    - `updatedAt` string
    - `volume` number
  - `pagination` FtMarketServiceV2PkgApiPagination
    - `hasMore` boolean
    - `totalResults` integer

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.dev/42/apis/fortytwo-read-api.md) · [All operations](https://skmtc.dev/42/apis/fortytwo-read-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/42/fortytwo-read-api/revisions/660740bda403/schema)