POST /api/economy/ingest

Pushes player balances into the project's economy snapshots. Designed to be called from the server as a player disconnects, so balances stay current between Open Cloud scans. See the Economy Monitoring guide for context.

Headers

x-api-key: rs_your_project_key
content-type: application/json

Request body

{
  "players": [
    {
      "user_id": 123456,
      "profile": {
        "RPCharacterOne": { "Cash": 5000, "InATM": 12000, "DarkCoin": 3 },
        "RPCharacterTwo": { "Cash": 800 },
        "DataCode": 5
      }
    }
  ]
}

• user_id: numeric Roblox user ID
• profile: the raw ProfileService profile table for that player

Batch limit is 100 players per request. Entries with a non-numeric user_id, missing profile, or no RPCharacterOne/RPCharacterTwo are skipped.

Behavior

• Parsed identically to the Open Cloud scan: cash = summed Cash, bank = summed InATM, dark_coin = summed DarkCoin, plus display names and data_code.
• Upserts by user_id, overwriting any previously scanned snapshot for that player.
• last_logout is set to the time of the push, not read from the profile.

Responses

• 200: { "stored": <number> }
• 400: empty batch, batch over limit, or no valid player payloads
• 401: missing or invalid API key
• 500: storage failure