Segments — Trend — Rockmoon Docs

Pre-pivoted per-segment time series. Drop into a chart library without grouping client-side.

GET /v1/segments/{ticker}/trend basic+

Parameters

Name	Type	Req	Description
ticker	path	yes	Ticker symbol.

Example

curl -H "X-API-Key: rk_YOUR_KEY" \
  https://api.rockmoon.ai/v1/segments/AAPL/trend

r = requests.get(
    "https://api.rockmoon.ai/v1/segments/AAPL/trend",
    headers={"X-API-Key": "rk_YOUR_KEY"},
)
trend = r.json()["trend"]
for label, points in trend.items():
    print(label, len(points), "points")

const r = await fetch(
  "https://api.rockmoon.ai/v1/segments/AAPL/trend",
  { headers: { "X-API-Key": "rk_YOUR_KEY" } },
);
const { trend } = await r.json();

Response 200

{
  "ticker": "AAPL",
  "market": "US",
  "concept": "revenue",
  "trend": {
    "Americas Segment": [
      { "period_end": "2017-09-30", "value":  96600000000 },
      { "period_end": "2018-09-29", "value": 112093000000 },
      { "period_end": "2019-09-28", "value": 116914000000 },
      { "period_end": "2020-09-26", "value": 124556000000 },
      { "period_end": "2021-09-25", "value": 153306000000 },
      { "period_end": "2022-09-24", "value": 169658000000 },
      { "period_end": "2023-09-30", "value": 162560000000 },
      { "period_end": "2024-09-28", "value": 167045000000 },
      { "period_end": "2025-09-27", "value": 178353000000 }
    ],
    "Europe Segment": [
      { "period_end": "2017-09-30", "value":  54938000000 },
      { "period_end": "2018-09-29", "value":  62420000000 },
      { "period_end": "2019-09-28", "value":  60288000000 },
      { "period_end": "2020-09-26", "value":  68640000000 },
      { "period_end": "2021-09-25", "value":  89307000000 },
      { "period_end": "2022-09-24", "value":  95118000000 },
      { "period_end": "2023-09-30", "value":  94294000000 },
      { "period_end": "2024-09-28", "value": 101328000000 },
      { "period_end": "2025-09-27", "value": 111032000000 }
    ],
    "Greater China Segment": [
      { "period_end": "2017-09-30", "value":  44764000000 },
      { "period_end": "2018-09-29", "value":  51942000000 },
      { "period_end": "2019-09-28", "value":  43678000000 },
      { "period_end": "2020-09-26", "value":  40308000000 },
      { "period_end": "2021-09-25", "value":  68366000000 },
      { "period_end": "2022-09-24", "value":  74200000000 },
      { "period_end": "2023-09-30", "value":  72559000000 },
      { "period_end": "2024-09-28", "value":  66952000000 },
      { "period_end": "2025-09-27", "value":  64377000000 }
    ],
    "iPhone": [
      { "period_end": "2019-09-28", "value": 142381000000 },
      { "period_end": "2020-09-26", "value": 137781000000 },
      { "period_end": "2021-09-25", "value": 191973000000 },
      { "period_end": "2022-09-24", "value": 205489000000 },
      { "period_end": "2023-09-30", "value": 200583000000 },
      { "period_end": "2024-09-28", "value": 201183000000 },
      { "period_end": "2025-09-27", "value": 209586000000 }
    ],
    "Service": [
      { "period_end": "2021-09-25", "value":  68425000000 },
      { "period_end": "2022-09-24", "value":  78129000000 },
      { "period_end": "2023-09-30", "value":  85200000000 },
      { "period_end": "2024-09-28", "value":  96169000000 },
      { "period_end": "2025-09-27", "value": 109158000000 }
    ],
    "Mac": [
      { "period_end": "2021-09-25", "value":  35190000000 },
      { "period_end": "2022-09-24", "value":  40177000000 },
      { "period_end": "2023-09-30", "value":  29357000000 },
      { "period_end": "2024-09-28", "value":  29984000000 },
      { "period_end": "2025-09-27", "value":  33708000000 }
    ]
  }
}

Errors

HTTP	Code	Cause
403	`upgrade_required`	Segments are a Basic+ feature.
404	`ticker_not_found`	Unknown ticker.
429	`rate_limit_exceeded`	Rate limit hit. Honor `Retry-After`.

Notes

Concept defaults to revenue — the most commonly charted series.
Label rename: filers occasionally rename a segment across periods. Old and new labels appear as separate keys; merge client-side if you need continuity.
Sort order: points within each segment are oldest-first.

Segment trend

Parameters

Example

Notes