# Stack Wars

## Stack wars listings and details

> Public endpoint for viewing stack war competitions and their AI-generated summaries. Admin actions (create, ai-summary) are on a separate endpoint.<br>

```json
{"openapi":"3.0.3","info":{"title":"Indexify API","version":"0.1.12-beta"},"servers":[{"url":"https://api.indexify.finance","description":"Production"}],"security":[{},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY","description":"API key with the `ix_` prefix. You can generate an API Key by navigating to Settings -> API Key in the web app. Pass it in the `X-API-KEY` header on every request."}},"schemas":{"StackObject":{"type":"object","description":"Canonical stack representation returned by discovery and fetch actions. Exact fields may vary by context (discovery vs portfolio vs trending).\n","properties":{"id":{"type":"integer"},"stack_name":{"type":"string"},"slug":{"type":"string"},"description":{"type":"string","nullable":true},"topic":{"type":"string","nullable":true,"description":"Stack risk/duration category."},"creator_fee":{"type":"number"},"price":{"type":"number","nullable":true},"weighted_market_cap":{"type":"number","nullable":true},"change4H":{"type":"number","nullable":true},"change1D":{"type":"number","nullable":true},"change1W":{"type":"number","nullable":true},"change1M":{"type":"number","nullable":true},"changeAll":{"type":"number","nullable":true},"token_count":{"type":"integer"},"investor_count":{"type":"integer"},"is_company_stack":{"type":"boolean"},"archived":{"type":"boolean"},"show_creator_holdings":{"type":"boolean"},"created_at":{"type":"integer","description":"Unix timestamp."},"time_p":{"type":"integer","nullable":true,"description":"Unix timestamp of last price update."},"tvl":{"type":"number","nullable":true,"description":"Total Value Locked in USD. Only present when tvl=true in request."},"user":{"type":"object","description":"Public creator profile.","properties":{"username":{"type":"string"},"avatar":{"type":"string","nullable":true},"bio":{"type":"string","nullable":true},"stacks_count":{"type":"integer"},"telegram":{"type":"string","nullable":true},"discord":{"type":"string","nullable":true},"twitter":{"type":"string","nullable":true},"linkedin":{"type":"string","nullable":true},"personal":{"type":"string","nullable":true}}},"tokens":{"type":"array","description":"Token allocations within the stack.","items":{"type":"object","properties":{"address":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"image_url":{"type":"string","nullable":true},"weight":{"type":"number"},"is_verified":{"type":"boolean"}}}}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}},"paths":{"/api/stack_wars.php":{"post":{"tags":["Stack Wars"],"summary":"Stack wars listings and details","description":"Public endpoint for viewing stack war competitions and their AI-generated summaries. Admin actions (create, ai-summary) are on a separate endpoint.\n","parameters":[{"name":"action","in":"query","required":true,"schema":{"type":"string","enum":["list","detail"]}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"oneOf":[{"title":"list","description":"No request body required.","type":"object"},{"title":"detail","type":"object","required":["stack_war_id"],"properties":{"stack_war_id":{"type":"integer","description":"ID of the stack war to retrieve."}}}]}}}},"responses":{"200":{"description":"Successful response. Shape varies by action.","content":{"application/json":{"schema":{"oneOf":[{"title":"ListResponse","type":"object","properties":{"stack_wars":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"participant_count":{"type":"integer"},"status":{"type":"string","enum":["upcoming","active","completed"]},"start_time":{"type":"integer","description":"Unix timestamp."},"end_time":{"type":"integer","description":"Unix timestamp."},"has_ai_summary":{"type":"boolean"},"current_leader":{"type":"string","nullable":true},"created_at":{"type":"integer","description":"Unix timestamp."}}}},"total":{"type":"integer"},"active_count":{"type":"integer"},"upcoming_count":{"type":"integer"}}},{"title":"DetailResponse","type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"participant_stack_ids":{"type":"array","items":{"type":"integer"}},"participant_count":{"type":"integer"},"status":{"type":"string","enum":["upcoming","active","completed"]},"start_time":{"type":"integer","description":"Unix timestamp."},"end_time":{"type":"integer","description":"Unix timestamp."},"created_at":{"type":"integer","description":"Unix timestamp."},"updated_at":{"type":"integer","nullable":true,"description":"Unix timestamp."},"ai_summary":{"type":"string","nullable":true,"description":"AI-generated markdown summary of the war."},"analyzed_at":{"type":"integer","nullable":true,"description":"Unix timestamp of last AI analysis."},"data_points_analyzed":{"type":"integer","nullable":true},"participant_stacks":{"type":"array","items":{"$ref":"#/components/schemas/StackObject"}}}}]}}}},"400":{"description":"Missing or invalid stack_war_id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Stack war not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```