Skip to content

docs: document token concentration endpoint - #1159

Merged
Sulex45 merged 2 commits into
stellarkit-lab-devtools:mainfrom
LuckyBeekeper:fix/issue-1152-get-account-id-token-concentration-measure-how
Oct 24, 2026
Merged

Sulex45 merged 2 commits into
stellarkit-lab-devtools:mainfrom
LuckyBeekeper:fix/issue-1152-get-account-id-token-concentration-measure-how

Conversation

@LuckyBeekeper

Copy link
Copy Markdown
Contributor

Overview

This PR documents the GET /account/:id/token-concentration endpoint, which measures how concentrated an account's token (non-native) holdings are. It returns a concentration risk label derived from the HHI methodology, the top holding's share of total token value, and supporting fields so portfolio risk tools can flag dangerously concentrated positions.

Related Issue

Changes

📄 Account Endpoint Docs

  • [MODIFY] docs/account-endpoints.md
    • Added documentation for GET /account/:id/token-concentration.
    • Documented the response shape: { success: true, data: { accountId, concentrationRisk, topHoldingPercent, topHoldingAsset, tokenCount, hhi } }.
    • Documented the concentrationRisk thresholds: critical above 8000 HHI, high above 5000, moderate above 2500, and low below 2500.
    • Noted that the endpoint returns 404 when the account does not exist.
    • Clarified that the computation focuses specifically on token (non-native) positions.

Verification Results

Docs-only change — no code or tests modified.
Acceptance Criteria Status
Returns { success: true, data: { accountId, concentrationRisk, topHoldingPercent, topHoldingAsset, tokenCount, hhi } } ✅ Documented response shape
concentrationRisk is "critical" above 8000 HHI, "high" above 5000, "moderate" above 2500, and "low" below 2500 ✅ Thresholds documented
Returns 404 if account does not exist ✅ Documented error case

Closes #1152

@Sulex45
Sulex45 merged commit 3ce89b1 into stellarkit-lab-devtools:main Oct 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

GET /account/:id/token-concentration — Measure how concentrated an account’s token holdings are

2 participants