Endpoints for Mercenary Den.

[EstamelGG]

Feature Request

Add new API endpoints related to Mercenary Den.

Use case

This feature is for players, alliance leaders, and third-party developers who wish to query detailed information about Mercenary Dens, including their reinforce, location, resource output, MTO (Mercenary Tactical Operations), and potentially their ownership or state.

Authentication

These endpoints may expose semi-sensitive game data. Depending on the granularity:

• Owner-specific or alliance-restricted data (e.g. production details, internal enhancements): Requires a new scope, such as read_mercenary_dens.

Example return

[
  {
    "den_id": 123456,
    "location": {
      "region_id": 10000002,
      "constellation_id": 20000029,
      "system_id": 30000175
    },
    "enhancement_status": {
      "level": 3,
      "active_modifiers": [
        "training_speed_boost",
        "reduced_resource_cost"
      ]
    },
    "resource_output": {
      "last_hour": 3200,
      "daily_average": 2980,
      "resource_type": "Combat Units"
    },
    "mto": 5.4,
    "owner_alliance_id": 99006542,
    "last_updated": "2025-07-21T15:45:00Z"
  }
]

Checklist

• [x] Feature request description is provided
• [x] Use case exists
• [x] Feature requires a new route
• [ ] Feature adds data to existing route
• [x] Feature requires new auth scope
• [ ] Feature can reuse existing scope
• [ ] Feature does not require auth
• [ ] Meta feature, applies to all routes