---
title: "Get market by address"
method: GET
path: "/api/v1/markets/{market_address}"
tags: ["get-market-by-address"]
---

# Get market by address

`GET /api/v1/markets/{market_address}`

Returns full market details for a single market identified by its on-chain contract address, including outcomes, collateral info, status, volume, and proposer.

## Path parameters

- `market_address` string, required

## Query parameters

- `locale` string

## Response `200`

OK

- InternalHandlerMarketResponse — Full market representation.
  - `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

## Other responses

- `404` — Not Found
- `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)