Share Orders Data Export

This service exports the share_orders table every 2 minutes.

CSV Download: /download/csv
JSON API (All): /json (all orders grouped by type)
JSON API (Clubs): /clubs (club orders only)
JSON API (Players): /players (player orders only)
JSON API (Leagues): /leagues (national leagues for current season)
JSON API (League Tables): /league_tables (all league standings)
Filtered API (Division 1 Tables): /api/league_tables?country_ids=ENG,ITA,ESP (Division 1 standings for specific countries)

JSON Format

All JSON endpoints use a compact array format to minimize file size. The share_id (club_id or player_id) is the object key, and each order is represented as an array:

"share_id": [[order_id, name, is_ask, price, num], ...]

Example Response (/clubs endpoint):

{
  "meta": {
    "fields": ["order_id", "name", "is_ask", "price", "num"],
    "updated": "2024-08-05T15:30:00"
  },
  "data": {
    "329": [
      [140193, "darkclaw2", 1, 10000000, 100],
      [140195, "user123", 0, 9500000, 50]
    ],
    "789": [
      [140165, "Mikelo", 1, 1000000, 1]
    ]
  }
}

In this example, club ID 329 has two orders: a sell order from darkclaw2 and a buy order from user123.

Note: When the name field is null, it indicates a system-generated order or an order from a deleted account.

Leagues Format (/leagues endpoint)

The leagues endpoint returns all national leagues (comp_type = 0) for the current season. The league_id is the object key, and data is in compact array format:

Example Response:

{
  "meta": {
    "fields": ["name", "group", "level", "ticket_cost", "tv_money", "prize_money_pot",
               "ave_attendance", "ave_club_rating_start", "num_teams", "round",
               "num_rounds", "comp_type", "country_id"],
    "season_id": 2,
    "updated": "2024-08-05T15:30:00"
  },
  "data": {
    "1": ["ENG", 0, "0", 1500000, 5000000000, 500000000000, 45000, 75, 20, 38, 38, 0, "ENG"],
    "2": ["ENG", 0, "1", 1200000, 3000000000, 300000000000, 30000, 68, 24, 46, 46, 0, "ENG"]
  }
}

League Tables Format (/league_tables endpoint)

The league_tables endpoint returns standings for all national leagues. The league_id is the object key, containing an array of team records:

Example Response:

{
  "meta": {
    "fields": ["club_id", "club_ix", "played", "won", "drawn", "lost", "goals_for",
             "goals_against", "pts", "form", "old_position", "new_position",
             "fans_start", "fans_current", "stadium_size_current", "manager_name"],
    "season_id": 2,
    "updated": "2024-08-05T15:30:00"
  },
  "data": {
    "1": [
      [329, 0, 38, 28, 6, 4, 89, 25, 90, "WWDWW", 1, 1, 68500, 73798, 76212, "alice"],
      [456, 1, 38, 25, 8, 5, 76, 32, 83, "DWWLW", 2, 2, 49000, 52127, 52758, "bob"],
      [789, 2, 38, 22, 9, 7, 68, 41, 75, "LDWWW", 3, 3, 22000, 24767, 28940, "charlie"]
    ]
  }
}

Filtered League Tables API (/api/league_tables endpoint)

The /api/league_tables endpoint provides filtered league standings for Division 1 (top tier) only, with country filtering via query parameters.

Query Parameters:

Usage Examples:

Response Format:

The response includes the same team fields as the standard /league_tables endpoint, but filtered to only include Division 1 leagues for the specified countries. Each league now includes metadata (country_id and division) along with the teams array. The metadata includes additional information about the applied filters:

{
  "meta": {
    "fields": ["club_id", "club_ix", "played", "won", "drawn", "lost", "goals_for",
             "goals_against", "pts", "form", "old_position", "new_position",
             "fans_start", "fans_current", "stadium_size_current", "manager_name"],
    "season_id": 2,
    "updated": "2024-08-05T15:30:00",
    "filtered_by": {
      "division": 1,
      "country_ids": ["ENG", "ITA", "ESP"]
    },
    "total_leagues": 3
  },
  "data": {
    "1": {
      "country_id": "ENG",
      "division": 1,
      "teams": [
        [329, 0, 38, 28, 6, 4, 89, 25, 90, "WWDWW", 1, 1, 68500, 73798, 76212, "alice"],
        [456, 1, 38, 25, 8, 5, 76, 32, 83, "DWWLW", 2, 2, 49000, 52127, 52758, "bob"]
      ]
    },
    "5": {
      "country_id": "ITA",
      "division": 1,
      "teams": [
        [890, 0, 38, 30, 5, 3, 95, 22, 95, "WWWWW", 1, 1, 85000, 91234, 95000, "charlie"]
      ]
    }
  }
}

Response Structure:

Benefits: This filtered API is ideal for:

Note: The country codes are case-insensitive (e.g., "eng", "ENG", or "Eng" all work). Invalid country codes are ignored. Maximum 50 country codes can be requested at once.