Get market by address

GET /api/v1/markets/{market_address}

Get market by address

get

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_addressstringRequired

Market contract address

Responses

200

OK

application/json

Full market representation.

addressstringOptional

ancillaryDatastring[]Optional

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.

categoriesstring[]Optional

collateralAddressstringOptional

collateralDecimalsintegerOptional

collateralSymbolstringOptional

contractVersionintegerOptional

On-chain contract version that produced this market (1 = legacy, 2 = v2).

createdAtstringOptional

curvestringOptional

descriptionstringOptional

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.

elapsedPctnumberOptional

endDatestringOptional

feeRatenumberOptional

finalisedAtstringOptional

imagestringOptional

isFlaggedbooleanOptional

True when the question currently has an active creator-issued flag whose expiry (if any) is in the future.

questionstringOptional

questionIdstringOptional

resolutionTimestringOptional

resolvedAnswerstringOptional

slugstringOptional

startDatestringOptional

statusstringOptional

subcategoriesstring[]Optional

tagsstring[]Optional

topicsstring[]Optional

totalMarketCapnumberOptional

tradersintegerOptional

updatedAtstringOptional

volumenumberOptional

404

Not Found

application/json

500

Internal Server Error

application/json

get

/api/v1/markets/{market_address}

HTTPcURLJavaScriptPython

GET /api/v1/markets/{market_address} HTTP/1.1
Host: rest.ft.42.space/
Accept: */*

{
  "address": "text",
  "ancillaryData": [
    "text"
  ],
  "categories": [
    "text"
  ],
  "collateralAddress": "text",
  "collateralDecimals": 1,
  "collateralSymbol": "text",
  "contractVersion": 1,
  "createdAt": "text",
  "creator": {
    "address": "text",
    "image": "text",
    "name": "text"
  },
  "curve": "text",
  "description": "text",
  "elapsedPct": 1,
  "endDate": "text",
  "feeRate": 1,
  "finalisedAt": "text",
  "image": "text",
  "isFlagged": true,
  "oracle": {
    "address": "text",
    "image": "text",
    "name": "text"
  },
  "outcomes": [
    {
      "holdersAtFinalisation": 1,
      "image": "text",
      "index": 1,
      "marketCap": 1,
      "mintedQuantity": 1,
      "name": "text",
      "payout": 1,
      "price": 1,
      "symbol": "text",
      "tokenId": "text",
      "volume": 1
    }
  ],
  "proposer": {
    "image": "text",
    "name": "text"
  },
  "question": "text",
  "questionId": "text",
  "resolutionTime": "text",
  "resolvedAnswer": "text",
  "slug": "text",
  "startDate": "text",
  "status": "text",
  "subcategories": [
    "text"
  ],
  "tags": [
    "text"
  ],
  "topics": [
    "text"
  ],
  "totalMarketCap": 1,
  "traders": 1,
  "updatedAt": "text",
  "volume": 1
}