# FonHareketleri.com — LLM API Documentation

FonHareketleri.com tracks Turkish TEFAS mutual fund prices, daily returns, investor counts, and category statistics.

Base URL: https://fonhareketleri.com

## Authentication

GET requests to most endpoints are public and require no authentication. Exception: `/api/fund-daily-data/` requires authentication for all operations.

## Endpoints

### List Funds
GET /api/funds/

Returns TEFAS funds, paginated (50 per page).

Fields:
- code (string, 3 chars) — primary key, e.g. "AAK"
- name (string) — fund name in Turkish
- category (object) — { id, name }
- tefas_tradability (object or null) — { id, name }
- isin_code (string) — ISIN identifier
- risk_value (integer, 1–7) — risk level

Example response shape:
{
  "count": 1200,
  "next": "https://fonhareketleri.com/api/funds/?page=2",
  "previous": null,
  "results": [
    {
      "code": "AAK",
      "name": "Ak Portföy Euro Tahvil Fonu",
      "category": { "id": 3, "name": "Borçlanma Araçları Fonu" },
      "tefas_tradability": { "id": 1, "name": "Alınabilir ve Satılabilir" },
      "isin_code": "TRF..." ,
      "risk_value": 3
    }
  ]
}

---

### Get Single Fund
GET /api/funds/{code}/

Returns a single fund by its 3-character code. Code lookup is case-insensitive.

Example: GET /api/funds/AAK/

---

### Fund Price History
GET /api/funds/{code}/history/

Returns paginated daily snapshots for a fund.

Fields per record:
- id (integer)
- fund (string) — fund code
- last_price (decimal string) — unit price in TRY
- last_price_date (string, YYYY-MM-DD) — date of the snapshot
- daily_return (decimal string) — daily return as a percentage
- fund_total_value (decimal string) — total fund value in TRY
- return_1_month (decimal string or null)
- return_3_month (decimal string or null)
- return_6_month (decimal string or null)
- return_1_year (decimal string or null)
- market_share (decimal string) — fund's share of total TEFAS AUM
- number_of_investors (integer)
- shares (decimal string) — total shares outstanding

Example: GET /api/funds/AAK/history/

---

### List Categories
GET /api/categories/

Returns all fund categories (e.g. "Borçlanma Araçları Fonu", "Hisse Senedi Fonu").

Fields:
- id (integer)
- name (string)

---

### All Daily Data
GET /api/fund-daily-data/

Returns all daily snapshots across all funds, paginated. Same fields as /history/ above plus the fund code.

Requires authentication.

---

## Pagination

All list endpoints use page-based pagination. Default page size is 50. Use the `next` field in the response to get the next page.

Query parameter: ?page=2

---

## Notes

- All field names and category names are in Turkish.
- Dates follow ISO 8601 format (YYYY-MM-DD).
- Decimal values are returned as strings to preserve precision.
- The fund code (3 chars, e.g. "AAK") is the canonical identifier used across all endpoints.

## Contact

For API questions, feature requests, or bug reports: fonhareketleri@gmail.com