# Get market by address

GET /api/v1/markets/{market\_address}

## Get market by address

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

```json
{"openapi":"3.1.1","info":{"title":"FortyTwo Read API","version":"1.0"},"tags":[{"description":"GET /api/v1/markets/{market_address}","name":"get-market-by-address"}],"servers":[{"url":"https://rest.ft.42.space/"}],"paths":{"/api/v1/markets/{market_address}":{"get":{"description":"Returns full market details for a single market identified by its on-chain contract address, including outcomes, collateral info, status, volume, and proposer.","tags":["get-market-by-address"],"summary":"Get market by address","parameters":[{"schema":{"type":"string"},"description":"Market contract address","name":"market_address","in":"path","required":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.MarketResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.ErrorResponse"}}}}}}}},"components":{"schemas":{"handler.MarketResponse":{"description":"Full market representation.","type":"object","properties":{"address":{"type":"string"},"categories":{"type":"array","items":{"type":"string"}},"collateralAddress":{"type":"string"},"collateralDecimals":{"type":"integer"},"collateralSymbol":{"type":"string"},"createdAt":{"type":"string"},"curve":{"type":"string"},"description":{"type":"string"},"elapsedPct":{"type":"number"},"endDate":{"type":"string"},"feeRate":{"type":"number"},"finalisedAt":{"type":"string"},"image":{"type":"string"},"outcomes":{"type":"array","items":{"$ref":"#/components/schemas/handler.OutcomeResponse"}},"proposer":{"$ref":"#/components/schemas/handler.ProposerResponse"},"question":{"type":"string"},"questionId":{"type":"string"},"resolvedAnswer":{"type":"string"},"resolutionTime":{"type":"string"},"slug":{"type":"string"},"startDate":{"type":"string"},"status":{"type":"string"},"subcategories":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"topics":{"type":"array","items":{"type":"string"}},"totalMarketCap":{"type":"number"},"traders":{"type":"integer"},"updatedAt":{"type":"string"},"volume":{"type":"number"}}},"handler.OutcomeResponse":{"description":"Per-outcome data including price, volume, and supply.","type":"object","properties":{"holdersAtFinalisation":{"type":"integer"},"image":{"type":"string"},"index":{"type":"integer"},"marketCap":{"type":"number"},"mintedQuantity":{"type":"number"},"name":{"type":"string"},"payout":{"type":"number"},"price":{"type":"number"},"symbol":{"type":"string"},"tokenId":{"type":"string"},"volume":{"type":"number"}}},"handler.ProposerResponse":{"type":"object","properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"image":{"type":"string"},"name":{"type":"string"}}},"api.ErrorResponse":{"type":"object","properties":{"code":{"type":"integer"},"error":{"type":"string"},"message":{"type":"string"}}}}}}
```