> ## Documentation Index > Fetch the complete documentation index at: https://docs.vibechain.com/llms.txt > Use this file to discover all available pages before exploring further. # List market chat messages > Cursor-paginated chat and system activity. Responses are cached for about 60 seconds with shorter shared-cache headers. ## OpenAPI ````yaml /api-reference/vibemarket_openapi.yml get /chat-messages openapi: 3.0.3 info: title: vibe.market API version: 1.0.0 description: | Production API for vibe.market packs, games, collections, creator drafts, allowlists, market activity, social features, recovery tools, and analytics. Most operations require a caller-specific VibeChain API key in the `API-KEY` header. Account-bound writes additionally require a vibe.market session token in `Authorization: Bearer `. Public or Bearer-only exceptions are marked on the individual operation. contact: name: VibeChain developer support email: gm@vibechain.com url: https://docs.vibechain.com/api-reference/vibemarket-intro servers: - url: https://build.vibechain.com/vibe/boosterbox description: Production security: - ApiKeyAuth: [] tags: - name: Packs description: Read pack ownership, state, rarity, and metadata. - name: Collections description: Read collection holdings, statistics, and activity. - name: Games description: Discover games and read launch configuration. - name: Metadata description: Read published metadata and update launched collections. - name: Creator drafts description: Create, autosave, inspect, confirm, and delete launch drafts. - name: Allowlists description: Configure draft allowlists and generate Merkle proofs. - name: Activity description: Read recent packs and recover indexed transaction events. - name: Social description: Read chat, react to messages, and report collections. - name: Analytics description: Read price history, leaderboards, and platform totals. - name: Utility description: Resolve slugs, regions, prices, and processing readiness. paths: /chat-messages: get: tags: - Social summary: List market chat messages description: >- Cursor-paginated chat and system activity. Responses are cached for about 60 seconds with shorter shared-cache headers. operationId: listVibeMarketChatMessages parameters: - in: query name: contractAddress schema: $ref: '#/components/schemas/EvmAddress' - in: query name: limit schema: type: integer minimum: 1 maximum: 200 default: 48 - in: query name: cursor description: ISO timestamp returned by the preceding page. schema: type: string format: date-time - $ref: '#/components/parameters/ChainId' - in: query name: messageType schema: type: string enum: - system - user - rarity_assigned - bought_100_packs - bought_400_packs - all default: all - in: query name: includeUser schema: type: boolean default: true - in: query name: minRarity description: Minimum rarity code for rarity activity messages. schema: type: integer minimum: 0 maximum: 5 default: 2 - $ref: '#/components/parameters/BypassImageProxy' responses: '200': description: Chat page headers: Cache-Control: schema: type: string example: public, max-age=15, s-maxage=30, stale-while-revalidate=60 content: application/json: schema: $ref: '#/components/schemas/ChatMessagesResponse' '400': $ref: '#/components/responses/InvalidInput' '429': $ref: '#/components/responses/ApiKeyOrRateLimit' '500': $ref: '#/components/responses/InternalError' components: schemas: EvmAddress: type: string pattern: ^0x[a-fA-F0-9]{40}$ example: '0x1111111111111111111111111111111111111111' ChatMessagesResponse: type: object required: - success - messages - hasMore - pagination properties: success: type: boolean enum: - true messages: type: array items: $ref: '#/components/schemas/ChatMessage' nextCursor: type: string format: date-time nullable: true hasMore: type: boolean pagination: type: object additionalProperties: true properties: limit: type: integer nextCursor: type: string nullable: true ChatMessage: type: object required: - id - messageType - createdAt additionalProperties: true properties: id: type: string _id: type: string contractAddress: $ref: '#/components/schemas/EvmAddress' chainId: type: integer messageType: type: string enum: - system - user - rarity_assigned - bought_100_packs - bought_400_packs message: type: string ownerAddress: $ref: '#/components/schemas/EvmAddress' tokenId: type: integer rarity: $ref: '#/components/schemas/RarityCode' transactionHash: $ref: '#/components/schemas/TransactionHash' createdAt: type: string format: date-time user: $ref: '#/components/schemas/UserSummary' reactions: type: array items: $ref: '#/components/schemas/ChatReaction' Error: type: object required: - success - message properties: success: type: boolean enum: - false message: type: string error: description: >- Optional diagnostic detail. Do not depend on this field being present in production. oneOf: - type: string - type: object additionalProperties: true RarityCode: type: integer minimum: 0 maximum: 5 description: 0 not assigned, 1 Common, 2 Rare, 3 Epic, 4 Legendary, 5 Mythic. TransactionHash: type: string pattern: ^0x[a-fA-F0-9]{64}$ example: '0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' UserSummary: type: object additionalProperties: true properties: id: type: string username: type: string displayName: type: string profileImage: type: string format: uri address: $ref: '#/components/schemas/EvmAddress' ChatReaction: type: object additionalProperties: true properties: emoji: type: string count: type: integer minimum: 0 reactedByCurrentUser: type: boolean parameters: ChainId: in: query name: chainId description: EVM chain ID. Defaults to Base mainnet. schema: type: integer minimum: 1 default: 8453 BypassImageProxy: in: header name: X-Bypass-Image-Proxy description: >- Set to `true` to keep original recognized CDN URLs instead of vibe.market proxy URLs. Cache this response variant separately. schema: type: boolean default: false responses: InvalidInput: description: Invalid or incomplete request input content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false message: Invalid contract address ApiKeyOrRateLimit: description: API key missing/invalid or the caller's rate allowance is exhausted content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false message: >- Too many requests or invalid API key! See docs.vibechain.com for more info. InternalError: description: The server could not complete the operation content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false message: Failed to complete request securitySchemes: ApiKeyAuth: type: apiKey in: header name: API-KEY description: Caller-specific VibeChain API key used for quota and abuse control. ````