> ## Documentation Index > Fetch the complete documentation index at: https://docs.decibel.trade/llms.txt > Use this file to discover all available pages before exploring further. # Get market activity > The 7-day hourly price series and the 24h / 3d / 7d change, dollar volume, prior-window dollar volume and multiple for every perp market, keyed by market name. One entry per listed market; a market with no candles in the span has `null` figures and no series. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/market_activity openapi: 3.1.0 info: title: Decibel Trading API description: >- RESTful API for Decibel. Provides read-only endpoints for market data, trading operations, positions, and analytics. contact: name: Decibel Team url: https://decibel.trade/ license: name: '' version: 1.0.0 servers: - url: https://api.mainnet.aptoslabs.com/decibel description: Mainnet - url: https://api.testnet.aptoslabs.com/decibel description: Testnet security: - bearerAuth: [] tags: - name: Market Data description: Market information and real-time data endpoints - name: User description: User information and account management - name: Account description: Account-specific endpoints and data - name: Trades description: Trading operations and history - name: Positions description: User position management - name: Orders description: Order management and history - name: TWAP description: Time-weighted average price orders - name: Bulk Orders description: Bulk order management - name: Vaults description: Vault operations and management - name: Analytics description: Analytics and performance metrics - name: Points description: Points-related account metrics - name: Trading Points description: Trading points endpoints - name: Trading Hz description: Trading Hz endpoints - name: Tier description: Tier information endpoints - name: Streaks description: User streak tracking endpoints - name: Predeposit Rewards description: Season 0 predeposit USDC rewards - name: Referrals description: Referral code management and tracking - name: Affiliates description: Affiliate code and earnings endpoints - name: Campaigns description: On-chain reward campaign endpoints paths: /api/v1/market_activity: get: tags: - Market Data summary: Get market activity description: >- The 7-day hourly price series and the 24h / 3d / 7d change, dollar volume, prior-window dollar volume and multiple for every perp market, keyed by market name. One entry per listed market; a market with no candles in the span has `null` figures and no series. operationId: handle_market_activity responses: '200': description: Market activity retrieved successfully content: application/json: schema: $ref: '#/components/schemas/MarketActivityDto' '500': description: Database error components: schemas: MarketActivityDto: type: object description: >- The whole board's activity, keyed by market NAME — the key the client joins its rows on. (The 24h contexts endpoint keys by name too; an address here would leave every row without its shape and no error anywhere.) required: - producedAt - intervalMs - seriesDays - windowDays - markets properties: intervalMs: type: integer format: int64 description: Echo of [`ACTIVITY_INTERVAL_MS`], so a consumer never assumes it. markets: type: object additionalProperties: $ref: '#/components/schemas/MarketActivityRowDto' propertyNames: type: string producedAt: type: integer format: int64 description: >- When the candles were read from the venue, unix ms — and the as-of every figure and the series span are measured against. Not when this response was served: a cached read can be delivered up to a minute later. seriesDays: type: integer format: int64 description: Echo of [`ACTIVITY_SERIES_DAYS`]. windowDays: type: integer format: int64 description: >- Echo of [`ACTIVITY_WINDOW_DAYS`]: what the figures were measured over. MarketActivityRowDto: type: object required: - figures properties: figures: $ref: '#/components/schemas/ActivityFiguresDto' series: oneOf: - type: 'null' - $ref: '#/components/schemas/ActivitySeriesDto' description: '`null` when the market has no candle inside the series span.' ActivityFiguresDto: type: object required: - windows - rows properties: firstCloseMs: type: - integer - 'null' format: int64 description: Close time of the oldest candle that was evidence. lastCloseMs: type: - integer - 'null' format: int64 description: >- Close time of the newest candle that was evidence. `null` when there was none. rows: type: integer description: >- How many candles were evidence. Zero means every figure above is `null`. minimum: 0 windows: type: object additionalProperties: $ref: '#/components/schemas/ActivityWindowFiguresDto' propertyNames: type: string ActivitySeriesDto: type: object description: >- The sparkline, compressed: a start time and per-point offsets in whole intervals, so 168 hours ship as small integers instead of 168 timestamps. required: - t0 - o - c properties: c: type: array items: type: number format: double description: Close at each offset. o: type: array items: type: number format: double description: Offsets from `t0` in whole [`ACTIVITY_INTERVAL_MS`] units. t0: type: integer format: int64 description: Close time of the first shipped point, unix ms. ActivityWindowFiguresDto: type: object description: >- One window's resolved figures. Every field is `null` when it was not measured. properties: changePct: type: - number - 'null' format: double description: >- Signed percent from the window's reference close to the newest close. `null` when no candle closed at or before the window's start. dollarVolume: type: - number - 'null' format: double description: |- Dollar volume inside the window. `null` when the window is not fully served or any candle inside it carried no volume. multiple: type: - number - 'null' format: double description: >- `dollar_volume / prior_dollar_volume`, only when both resolved and the prior is strictly positive: a prior window that traded nothing is not infinite growth, it is an unmeasurable multiple. priorDollarVolume: type: - number - 'null' format: double description: The same figure over the window immediately before this one. securitySchemes: bearerAuth: type: http scheme: bearer description: >- Bearer token from Geomi. See [Authentication](/api-reference/rest/authentication) for setup instructions. ````