Economy API

Read economy metrics programmatically — useful for piping Qyren data into your own BI tools or Slack bots. Confirm the exact endpoint paths in your dashboard; these are indicative. All endpoints: Authorization: Bearer qyr_live_<your-key>.

Health Score

GET https://api.qyren.ai/v1/economy/health?game_id=origins_of_lume

Response:

{
  "game_id": "origins_of_lume",
  "as_of": "2026-04-13T00:00:00Z",
  "score": 78,
  "band": "good",
  "components": {
    "sink_source_balance": 22,
    "price_stability": 19,
    "currency_velocity": 21,
    "payer_distribution": 16
  }
}

Each component is out of 25. Score is their sum.

Sink-to-source ratio

GET https://api.qyren.ai/v1/economy/ratio?game_id=origins_of_lume&window=7d

Optional currency query param to filter. Response:

{
  "game_id": "origins_of_lume",
  "window": "7d",
  "as_of": "2026-04-13T00:00:00Z",
  "ratios": [
    {"currency": "gold", "earned": 420000000, "spent": 310000000, "ratio": 0.74},
    {"currency": "gems", "earned": 8200000,   "spent": 9100000,   "ratio": 1.11}
  ]
}

Inflation rate

GET https://api.qyren.ai/v1/economy/inflation?game_id=origins_of_lume

Returns current monthly inflation per currency plus a 90-day trend array.

Currency flow breakdown

GET https://api.qyren.ai/v1/economy/flows?game_id=origins_of_lume&currency=gold&window=7d

Returns top faucets and top sinks by volume. Useful for spotting “which single faucet is ruining my ratio.”

Rate limits

Economy endpoints: 60 requests per minute per game. These are slower-changing metrics — no need to poll frequently. Daily is plenty.

Getting Started

Core Concepts

Economy Health

Recommendations

Billing

Integration

API Reference

Glossary

Health Score

Sink-to-source ratio

Inflation rate

Currency flow breakdown

Rate limits

​Health Score

​Sink-to-source ratio

​Inflation rate

​Currency flow breakdown

​Rate limits

Health Score

Sink-to-source ratio

Inflation rate

Currency flow breakdown

Rate limits