# Ekospor Sports Economics API

> Audited financial data, financial ratios and the Ekospor Club Finance Index (0–100) for the four football clubs listed on Borsa Istanbul: Beşiktaş (BJKAS), Fenerbahçe (FENER), Galatasaray (GSRAY) and Trabzonspor (TSPOR). Paid per request in USDC on Solana via the x402 protocol; no account or API key.

- Publisher: Ekospor (https://www.ekospor.com), a sports-economics research platform.
- Data period: fiscal year 1 June 2025 – 31 May 2026 (latest audited annual reports). Amounts in million TRY, inflation-adjusted under IAS 29 (TMS 29).
- Source: each club's independently audited consolidated annual financial report on KAP (Public Disclosure Platform of Turkey); every figure includes document and page number.
- Not included: stock/market prices. Not investment advice.

## Endpoints

- [GET /v1](https://api.ekospor.com/v1): API description (free)
- [GET /v1/kulupler](https://api.ekospor.com/v1/kulupler): covered clubs and periods (free)
- [GET /v1/ornek](https://api.ekospor.com/v1/ornek): sample response for Beşiktaş, index score hidden (free)
- GET /v1/kulup/{BJKAS|FENER|GSRAY|TSPOR}: one club's balance-sheet summary, ratios, index score, source pages — 0.05 USDC
- [GET /v1/endeks](https://api.ekospor.com/v1/endeks): ranking of all four clubs by the Ekospor Club Finance Index — 0.02 USDC

## Payment (x402)

Unpaid requests return HTTP 402 with a base64 JSON `PAYMENT-REQUIRED` header (scheme "exact", network Solana mainnet `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`, asset USDC). Sign the USDC transfer with an x402 client (e.g. `@x402/fetch` + `@x402/svm`) and retry with the `PAYMENT-SIGNATURE` header. Network fees are paid by the facilitator.

## Methodology (v1-dengeli)

Weighted 0–100 score: cost discipline 30% (personnel expenses / revenue), debt burden 25% (total liabilities / revenue), liquidity 30% (current ratio 20%, cash / short-term liabilities 10%), profitability 15% (net profit margin). 10 points are deducted if the auditor reports a material uncertainty related to going concern.

## Pages

- [English overview](https://api.ekospor.com/)
- [Türkçe tanıtım](https://api.ekospor.com/tr/)