--- title: "Get Market Details" method: GET path: "/markets/{addressOrSlug}" tags: ["Markets"] --- # Get Market Details `GET /markets/{addressOrSlug}` Retrieves market or group data using either an Ethereum address or a slug identifier ## Path parameters - `addressOrSlug` string, required ## Response `200` Market or group details with pricing and volume data - union - ClobMarketResponseDto - `id` number, required — Market ID - `conditionId` string, required — Condition ID - `negRiskRequestId` string, nullable, required — NegRisk request ID - `description` string, required — Market description - `collateralToken` CollateralTokenDto, required - `address` string, required — Token contract address - `decimals` number, required — Token decimal places - `symbol` string, required — Token symbol - `title` string, required — Market title - `proxyTitle` string, nullable, required — Proxy title - `expirationDate` string, required — Expiration date - `expirationTimestamp` number, required — Expiration timestamp - `createdAt` string, required — Created timestamp - `updatedAt` string, required — Updated timestamp - `categories` string[], required — Categories - `status` string, required — Market status - `expired` boolean, required — Is expired - `creator` CreatorDto, required - `name` string, required — Creator display name - `imageURI` string, nullable, required — Creator profile image URI - `link` string, nullable, required — Creator social media link - `address` string, required — Creator wallet address - `tags` string[], required — Tags - `frequency` string — Schedule frequency for timeline - `subFrequency` string, nullable — Schedule sub-frequency for timeline - `volume` string, required — Volume - `volumeFormatted` string, required — Formatted volume - `tokens` TokenPairDto, required - `yes` string, required — YES token ID - `no` string, required — NO token ID - `prices` number[], required — Prices - `tradePrices` TradePricesDto, required - `buy` object, required — Buy prices for market and limit orders - `market` number[] - `limit` number[] - `sell` object, required — Sell prices for market and limit orders - `market` number[] - `limit` number[] - `isRewardable` boolean, required — Is rewardable - `slug` string, required — Market slug - `tradeType` string, required — Trade type - `marketType` string, required — Market type - `priorityIndex` number, required — Priority index - `winningOutcomeIndex` number, nullable, required — Winning outcome index - `metadata` MetadataDto, required - `fee` boolean, required — Whether market has fees enabled - `isBannered` boolean, required — Whether market is featured in banner - `isPolyArbitrage` boolean, required — Whether market supports Polygon arbitrage - `shouldMarketMake` boolean — Whether market should be market made - `settings` MarketSettingsDto, required - `minSize` string, required — Minimum trade size in wei - `maxSpread` number, required — Maximum spread allowed - `dailyReward` string, required — Daily reward amount - `rewardsEpoch` string, required — Rewards epoch in decimal format - `c` string, required — C parameter - `logo` string, nullable, required — Market logo - `source` string, nullable, required — Market source (e.g. ugm:crypto, ugm:sports) - `feedEvents` FeedEventDto[] — Feed events - `eventType` 'NEW_TRADE' | 'MARKET_CREATED' | 'MARKET_RESOLVED', required — Type of feed event - `timestamp` string, required — Event timestamp in ISO format - `user` FeedEventUserDto, required - `id` number — User ID - `account` string, required — User wallet address - `username` string, nullable, required — Username - `displayName` string, nullable, required — Display name - `rankName` string — User ranking name - `points` string — User points balance - `name` string — User display name for feed events - `imageURI` string, nullable, required — User profile image URI - `data` FeedEventDataDto, required - `title` string, required — Market title - `address` string, required — Market contract address - `slug` string — Market slug - `strategy` 'Buy' | 'Sell', required — Trading strategy - `outcome` 'YES' | 'NO' | 'Up' | 'Down', required — Market outcome - `contracts` string, required — Number of contracts traded - `txHash` string, required — Transaction hash - `symbol` string, required — Collateral token symbol - `tradeAmount` string, required — Trade amount in collateral token - `tradeAmountUSD` string, required — Trade amount in USD - `marketId` number, required — Market ID - `bodyHash` string, required — Unique hash for the event - NegRiskGroupResponseDto - `id` number, required — Group ID - `slug` string, required — Group slug - `outcomeTokens` string[], required — Outcome tokens - `title` string, required — Group title - `ogImageURI` string, required — OG image URI - `imageUrl` string, nullable, required — Group image URL - `expirationDate` string, required — Expiration date - `expirationTimestamp` number, required — Expiration timestamp - `expired` boolean, required — Is expired - `creator` CreatorDto, required - `name` string, required — Creator display name - `imageURI` string, nullable, required — Creator profile image URI - `link` string, nullable, required — Creator social media link - `address` string, required — Creator wallet address - `collateralToken` CollateralTokenDto, required - `address` string, required — Token contract address - `decimals` number, required — Token decimal places - `symbol` string, required — Token symbol - `tags` string[], required — Tags - `frequency` string — Schedule frequency for timeline - `subFrequency` string, nullable — Schedule sub-frequency for timeline - `tradeType` string, required — Trade type - `marketType` string, required — Market type - `createdAt` string, required — Created timestamp - `updatedAt` string, required — Updated timestamp - `categories` string[], required — Categories - `status` string, required — Status - `priorityIndex` number, required — Priority index - `negRiskMarketId` string, required — NegRisk market ID - `markets` GroupMarketDto[], required — Markets in the group - `id` number, required — Market ID - `conditionId` string, required — Condition ID - `negRiskRequestId` string, nullable, required — NegRisk request ID - `description` string, required — Market description - `collateralToken` CollateralTokenDto, required - `address` string, required — Token contract address - `decimals` number, required — Token decimal places - `symbol` string, required — Token symbol - `title` string, required — Market title - `proxyTitle` string, nullable, required — Proxy title - `expirationDate` string, required — Expiration date - `expirationTimestamp` number, required — Expiration timestamp - `createdAt` string, required — Created timestamp - `updatedAt` string, required — Updated timestamp - `categories` string[], required — Categories - `status` string, required — Market status - `expired` boolean, required — Is expired - `creator` CreatorDto, required - `name` string, required — Creator display name - `imageURI` string, nullable, required — Creator profile image URI - `link` string, nullable, required — Creator social media link - `address` string, required — Creator wallet address - `tags` string[], required — Tags - `frequency` string — Schedule frequency for timeline - `subFrequency` string, nullable — Schedule sub-frequency for timeline - `volume` string, required — Volume - `volumeFormatted` string, required — Formatted volume - `tokens` TokenPairDto, required - `yes` string, required — YES token ID - `no` string, required — NO token ID - `prices` number[], required — Prices - `tradePrices` TradePricesDto, required - `buy` object, required — Buy prices for market and limit orders - `market` number[] - `limit` number[] - `sell` object, required — Sell prices for market and limit orders - `market` number[] - `limit` number[] - `isRewardable` boolean, required — Is rewardable - `slug` string, required — Market slug - `tradeType` string, required — Trade type - `marketType` string, required — Market type - `priorityIndex` number, required — Priority index - `winningOutcomeIndex` number, nullable, required — Winning outcome index - `metadata` MetadataDto, required - `fee` boolean, required — Whether market has fees enabled - `isBannered` boolean, required — Whether market is featured in banner - `isPolyArbitrage` boolean, required — Whether market supports Polygon arbitrage - `shouldMarketMake` boolean — Whether market should be market made - `settings` MarketSettingsDto, required - `minSize` string, required — Minimum trade size in wei - `maxSpread` number, required — Maximum spread allowed - `dailyReward` string, required — Daily reward amount - `rewardsEpoch` string, required — Rewards epoch in decimal format - `c` string, required — C parameter - `logo` string, nullable, required — Market logo - `source` string, nullable, required — Market source (e.g. ugm:crypto, ugm:sports) - `feedEvents` FeedEventDto[] — Feed events - `eventType` 'NEW_TRADE' | 'MARKET_CREATED' | 'MARKET_RESOLVED', required — Type of feed event - `timestamp` string, required — Event timestamp in ISO format - `user` FeedEventUserDto, required - `id` number — User ID - `account` string, required — User wallet address - `username` string, nullable, required — Username - `displayName` string, nullable, required — Display name - `rankName` string — User ranking name - `points` string — User points balance - `name` string — User display name for feed events - `imageURI` string, nullable, required — User profile image URI - `data` FeedEventDataDto, required - `title` string, required — Market title - `address` string, required — Market contract address - `slug` string — Market slug - `strategy` 'Buy' | 'Sell', required — Trading strategy - `outcome` 'YES' | 'NO' | 'Up' | 'Down', required — Market outcome - `contracts` string, required — Number of contracts traded - `txHash` string, required — Transaction hash - `symbol` string, required — Collateral token symbol - `tradeAmount` string, required — Trade amount in collateral token - `tradeAmountUSD` string, required — Trade amount in USD - `marketId` number, required — Market ID - `bodyHash` string, required — Unique hash for the event - `orderInGroup` number — Order in group - `metadata` MetadataDto, required - `fee` boolean, required — Whether market has fees enabled - `isBannered` boolean, required — Whether market is featured in banner - `isPolyArbitrage` boolean, required — Whether market supports Polygon arbitrage - `shouldMarketMake` boolean — Whether market should be market made - `volume` string, required — Volume - `volumeFormatted` string, required — Formatted volume - `dailyReward` string, required — Daily reward - `source` string, nullable, required — Market source (e.g. ugm:crypto, ugm:sports) - `feedEvents` FeedEventDto[], required — Feed events - `eventType` 'NEW_TRADE' | 'MARKET_CREATED' | 'MARKET_RESOLVED', required — Type of feed event - `timestamp` string, required — Event timestamp in ISO format - `user` FeedEventUserDto, required - `id` number — User ID - `account` string, required — User wallet address - `username` string, nullable, required — Username - `displayName` string, nullable, required — Display name - `rankName` string — User ranking name - `points` string — User points balance - `name` string — User display name for feed events - `imageURI` string, nullable, required — User profile image URI - `data` FeedEventDataDto, required - `title` string, required — Market title - `address` string, required — Market contract address - `slug` string — Market slug - `strategy` 'Buy' | 'Sell', required — Trading strategy - `outcome` 'YES' | 'NO' | 'Up' | 'Down', required — Market outcome - `contracts` string, required — Number of contracts traded - `txHash` string, required — Transaction hash - `symbol` string, required — Collateral token symbol - `tradeAmount` string, required — Trade amount in collateral token - `tradeAmountUSD` string, required — Trade amount in USD - `marketId` number, required — Market ID - `bodyHash` string, required — Unique hash for the event - AmmMarketResponseDto - `id` number, required — Market ID - `address` string, required — Market address - `conditionId` string, required — Condition ID - `description` string, required — Market description - `collateralToken` CollateralTokenDto, required - `address` string, required — Token contract address - `decimals` number, required — Token decimal places - `symbol` string, required — Token symbol - `title` string, required — Market title - `proxyTitle` string, nullable, required — Proxy title - `positionIds` string[], required — Position IDs - `ogImageURI` string, nullable, required — OG image URI - `expirationDate` string, required — Expiration date - `expirationTimestamp` number, required — Expiration timestamp - `createdAt` string, required — Created timestamp - `updatedAt` string, required — Updated timestamp - `categories` string[], required — Categories - `winningOutcomeIndex` number, nullable, required — Winning outcome index - `status` string, required — Market status - `expired` boolean, required — Is expired - `creator` CreatorDto, required - `name` string, required — Creator display name - `imageURI` string, nullable, required — Creator profile image URI - `link` string, nullable, required — Creator social media link - `address` string, required — Creator wallet address - `tags` string[], required — Tags - `openInterest` string, required — Open interest - `openInterestFormatted` string, required — Formatted open interest - `volume` string, required — Volume - `volumeFormatted` string, required — Formatted volume - `liquidity` string, required — Liquidity - `liquidityFormatted` string, required — Formatted liquidity - `slug` string, required — Market slug - `tradeType` string, required — Trade type - `marketType` string, required — Market type - `priorityIndex` number, required — Priority index - `metadata` MetadataDto, required - `fee` boolean, required — Whether market has fees enabled - `isBannered` boolean, required — Whether market is featured in banner - `isPolyArbitrage` boolean, required — Whether market supports Polygon arbitrage - `shouldMarketMake` boolean — Whether market should be market made - `logo` string, nullable, required — Market logo - `source` string, nullable, required — Market source (e.g. ugm:crypto, ugm:sports) - `feedEvents` FeedEventDto[], required — Feed events - `eventType` 'NEW_TRADE' | 'MARKET_CREATED' | 'MARKET_RESOLVED', required — Type of feed event - `timestamp` string, required — Event timestamp in ISO format - `user` FeedEventUserDto, required - `id` number — User ID - `account` string, required — User wallet address - `username` string, nullable, required — Username - `displayName` string, nullable, required — Display name - `rankName` string — User ranking name - `points` string — User points balance - `name` string — User display name for feed events - `imageURI` string, nullable, required — User profile image URI - `data` FeedEventDataDto, required - `title` string, required — Market title - `address` string, required — Market contract address - `slug` string — Market slug - `strategy` 'Buy' | 'Sell', required — Trading strategy - `outcome` 'YES' | 'NO' | 'Up' | 'Down', required — Market outcome - `contracts` string, required — Number of contracts traded - `txHash` string, required — Transaction hash - `symbol` string, required — Collateral token symbol - `tradeAmount` string, required — Trade amount in collateral token - `tradeAmountUSD` string, required — Trade amount in USD - `marketId` number, required — Market ID - `bodyHash` string, required — Unique hash for the event ## Other responses - `404` — Market or group not found - `500` — Server error when retrieving market/group data --- [API](https://skmtc.net/limitless/apis/limitless-exchange-api.md) · [All operations](https://skmtc.net/limitless/apis/limitless-exchange-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/limitless/limitless-exchange-api/versions/43f7d65e8e15/schema)