### Run tefasfon as Standalone Binary

Source: https://pypi.org/project/tefasfon

Execute the pre-built tefasfon binary directly without a Python installation. Ensure the file is executable before running.

```bash
# Windows
tefasfon-windows.exe funds -t SEC -s 01.01.2025 -e 31.01.2025 -x
```

```bash
# Linux / macOS
chmod +x tefasfon-linux   # or tefasfon-macos
./tefasfon-linux funds -t SEC -s 01.01.2025 -e 31.01.2025 -x
```

--------------------------------

### Install tefasfon Package

Source: https://pypi.org/project/tefasfon

Install the tefasfon package using pip. This command also registers the 'tefasfon' terminal command.

```bash
pip install tefasfon
```

--------------------------------

### Fetch Fund Returns (Return-Based, Specific Date Range)

Source: https://pypi.org/project/tefasfon

Retrieves the return rate for a specific period defined by start and end dates. This is useful for analyzing performance over custom intervals.

```python
from tefasfon import get_returns

# Return-based (specific date range)
df = get_returns(
    fund_type="PEN",
    basis="RB",
    start_date="01.04.2026",
    end_date="30.04.2026",
)
```

--------------------------------

### Python API: Get General Fund Information

Source: https://pypi.org/project/tefasfon

Fetch general fund information using the `get_funds` function. Specify fund type, date range, and optionally filter by fund codes or title keywords. The result is returned as a pandas DataFrame.

```python
from tefasfon import get_funds

df = get_funds(
    fund_type="SEC",
    start_date="01.04.2026",
    end_date="30.04.2026",
)
```

```python
df = get_funds(
    fund_type="PEN",
    start_date="01.04.2026",
    end_date="30.04.2026",
    fund_codes=["AEK", "AEY"],
)
```

```python
df = get_funds(
    fund_type="ETF",
    start_date="01.04.2026",
    end_date="30.04.2026",
    fund_title_contains=["ALTIN", "GÜMÜŞ"],
)
```

--------------------------------

### Run Standalone Binary (Windows)

Source: https://pypi.org/project/tefasfon/1.1.0

Execute the pre-built Windows executable for fetching fund data. Ensure the file is downloaded and accessible.

```bash
tefasfon-windows.exe funds -t SEC -s 01.01.2025 -e 31.01.2025 -x

```

--------------------------------

### Run Standalone Binary (Linux/macOS)

Source: https://pypi.org/project/tefasfon/1.1.0

Make the Linux or macOS standalone binary executable and run it to fetch fund data. Ensure the file is downloaded and accessible.

```bash
chmod +x tefasfon-linux   # or tefasfon-macos
./tefasfon-linux funds -t SEC -s 01.01.2025 -e 31.01.2025 -x

```

--------------------------------

### CLI: Pipe CSV Output to File

Source: https://pypi.org/project/tefasfon/1.1.0

Fetch securities fund data, format it as CSV, and redirect the output to a file named 'funds.csv'.

```bash
tefasfon funds -t SEC -s 01.04.2026 -e 30.04.2026 -o csv > funds.csv

```

--------------------------------

### CLI: Fetch Securities Funds to Excel

Source: https://pypi.org/project/tefasfon/1.1.0

Use the CLI to fetch securities funds for a specific date range and save the output to an Excel file.

```bash
tefasfon funds -t SEC -s 01.04.2026 -e 30.04.2026 -x

```

--------------------------------

### Fetch and Analyze Fund Data with Tefasfon

Source: https://pypi.org/project/tefasfon

Use `get_funds` to retrieve fund data and `analyze_funds` to calculate performance metrics. Specify fund type, date range, and analysis parameters like frequency and calculation method.

```python
from tefasfon import get_funds, analyze_funds

df = get_funds(
    fund_type="SEC",
    start_date="01.01.2026",
    end_date="30.04.2026",
)

metrics = analyze_funds(
    df,
    freq="B",
    method="log",
    risk_free_annual=0.40,
)

```

--------------------------------

### CLI: Fetch Size-Based Returns

Source: https://pypi.org/project/tefasfon/1.1.0

Retrieve size-based return data for real estate funds within a specified date range and save it to an Excel file. The '-b SB' option specifies size-based data.

```bash
tefasfon returns -t RE -b SB -s 01.04.2026 -e 30.04.2026 -x

```

--------------------------------

### Fetch Fund Returns (Return-Based, Standard Periods)

Source: https://pypi.org/project/tefasfon

Retrieves standard return metrics (1-month, 3-month, 1-year, etc.) for funds of a specified type. This is the default for return-based queries when no specific date range is provided.

```python
from tefasfon import get_returns

# Return-based (standard periods)
df = get_returns(
    fund_type="ETF",
    basis="RB",
)
```

--------------------------------

### CLI: Fetch Pension Funds by Code as CSV

Source: https://pypi.org/project/tefasfon/1.1.0

Fetch pension funds filtered by specific codes for a given date range and output the result as a CSV file.

```bash
tefasfon funds -t PEN -s 01.04.2026 -e 30.04.2026 -c AEK AEY -o csv

```

--------------------------------

### tefasfon CLI - Returns Command

Source: https://pypi.org/project/tefasfon/1.1.0

Fetches return data for funds using the 'returns' command. Supports filtering by type and date range, with different basis options.

```APIDOC
## tefasfon returns

### Description
Fetches return data for funds from the TEFAS website.

### Method
CLI Command

### Endpoint
N/A (CLI Tool)

### Parameters
#### Common Options
- **-t, --fund-type** (str) - Required - Type of fund (SEC, PEN, ETF, RE, VC)
- **-b, --basis** (str) - Required - Basis for returns (RB: Return-based, SB: Size-based, MB: Management fee-based)
- **-s, --start-date** (str) - Optional (required for SB/MB) - Start date in DD.MM.YYYY format
- **-e, --end-date** (str) - Optional (required for SB/MB) - End date in DD.MM.YYYY format
- **-x, --save-to-excel** - Optional - Save result to an Excel file (.xlsx)
- **-o, --output** (str) - Optional - Output format (csv or json)

### Request Example
```bash
tefasfon returns -t SEC -b RB -x
tefasfon returns -t PEN -b RB -s 01.04.2026 -e 30.04.2026 -o csv
tefasfon returns -t RE -b SB -s 01.04.2026 -e 30.04.2026 -x
```

### Response
Output is typically printed to stdout or saved to a file, depending on the options used. The structure depends on the output format (CSV, JSON, or Excel).
```

--------------------------------

### Fetch Fund Returns Data

Source: https://pypi.org/project/tefasfon/1.1.0

Use `get_returns` to fetch fund performance data. Specify the `basis` parameter to retrieve return-based, size-based, or management fee-based metrics. Date parameters are required for size-based and management fee-based returns.

```python
from tefasfon import get_returns

# Return-based (standard periods)
df = get_returns(
    fund_type="ETF",
    basis="RB",
)
```

```python
# Return-based (specific date range)
df = get_returns(
    fund_type="PEN",
    basis="RB",
    start_date="01.04.2026",
    end_date="30.04.2026",
)
```

```python
# Size-based
df = get_returns(
    fund_type="RE",
    basis="SB",
    start_date="01.04.2026",
    end_date="30.04.2026",
)
```

```python
# Management fee-based
df = get_returns(
    fund_type="SEC",
    basis="MB",
    start_date="01.04.2026",
    end_date="30.04.2026",
)
```

--------------------------------

### Fetch Fund Returns (Management Fee-Based)

Source: https://pypi.org/project/tefasfon

Retrieves fund performance data alongside management fee details. This is useful for analyzing the relationship between fees and returns.

```python
from tefasfon import get_returns

# Management fee-based
df = get_returns(
    fund_type="SEC",
    basis="MB",
    start_date="01.04.2026",
    end_date="30.04.2026",
)
```

--------------------------------

### tefasfon CLI: Fetch Securities Funds to Excel

Source: https://pypi.org/project/tefasfon

Use the 'funds' command to retrieve securities fund data for a specified date range and save the output to an Excel file.

```bash
tefasfon funds -t SEC -s 01.04.2026 -e 30.04.2026 -x
```

--------------------------------

### CLI: Fetch Pension Return Data by Date Range as CSV

Source: https://pypi.org/project/tefasfon/1.1.0

Fetch pension fund return data for a specific date range and output the result as a CSV file. The '-b RB' option specifies return-based data.

```bash
tefasfon returns -t PEN -b RB -s 01.04.2026 -e 30.04.2026 -o csv

```

--------------------------------

### Fetch Fund Returns (Size-Based)

Source: https://pypi.org/project/tefasfon

Retrieves data related to fund size changes and net returns over a specified period. This is useful for understanding how fund size impacts performance.

```python
from tefasfon import get_returns

# Size-based
df = get_returns(
    fund_type="RE",
    basis="SB",
    start_date="01.04.2026",
    end_date="30.04.2026",
)
```

--------------------------------

### CLI: Fetch Return-Based Data

Source: https://pypi.org/project/tefasfon/1.1.0

Retrieve return-based data for securities funds. The '-b RB' option specifies return-based data.

```bash
tefasfon returns -t SEC -b RB -x

```

--------------------------------

### tefasfon CLI: Pipe CSV Output to File

Source: https://pypi.org/project/tefasfon

Execute the 'funds' command to fetch securities fund data and pipe the CSV output directly to a file.

```bash
tefasfon funds -t SEC -s 01.04.2026 -e 30.04.2026 -o csv > funds.csv
```

--------------------------------

### CLI: Fetch ETF Funds by Title Keyword as JSON

Source: https://pypi.org/project/tefasfon/1.1.0

Fetch Exchange-Traded Funds (ETF) filtered by a keyword in their title for a specific date range and output the result as JSON.

```bash
tefasfon funds -t ETF -s 01.04.2026 -e 30.04.2026 -f ALTIN -o json

```

--------------------------------

### tefasfon CLI: Fetch Size-Based Returns

Source: https://pypi.org/project/tefasfon

Retrieve return data for a specified fund type and date range, using size-based calculations. Use '-x' to save the output to Excel.

```bash
tefasfon returns -t RE -b SB -s 01.04.2026 -e 30.04.2026 -x
```

--------------------------------

### tefasfon CLI: Fetch Return-Based Returns by Date Range as CSV

Source: https://pypi.org/project/tefasfon

Retrieve return data for a specified fund type and date range, outputting the results as CSV. The '-b RB' option specifies return-based calculations.

```bash
tefasfon returns -t PEN -b RB -s 01.04.2026 -e 30.04.2026 -o csv
```

--------------------------------

### tefasfon CLI: Fetch Pension Funds by Code as CSV

Source: https://pypi.org/project/tefasfon

Retrieve pension fund data, filtering by specific fund codes, and output the results in CSV format.

```bash
tefasfon funds -t PEN -s 01.04.2026 -e 30.04.2026 -c AEK AEY -o csv
```

--------------------------------

### tefasfon CLI: Fetch Return-Based Returns

Source: https://pypi.org/project/tefasfon

Retrieve return data for a specified fund type. The '-b RB' option indicates return-based calculations. Use '-x' to save to Excel.

```bash
tefasfon returns -t SEC -b RB -x
```

--------------------------------

### get_returns

Source: https://pypi.org/project/tefasfon

Fetches fund return data by fund type and basis. Supports different data views based on the 'basis' parameter and allows filtering and saving to Excel.

```APIDOC
## get_returns

### Description
Fetches fund return data by fund type and basis. Supports different data views based on the 'basis' parameter and allows filtering and saving to Excel.

### Parameters
#### Query Parameters
- **fund_type** (str) - Required - Type of fund: "SEC" Securities, "PEN" Pension, "ETF" Exchange-Traded Fund, "RE" Real Estate, "VC" Venture Capital
- **basis** (str) - Required - Basis for return data: "RB" Return-based, "SB" Size-based, "MB" Management fee-based
- **start_date** (str | None) - Optional - `DD.MM.YYYY`. Required for "SB" and "MB" basis, optional for "RB".
- **end_date** (str | None) - Optional - `DD.MM.YYYY`. Required for "SB" and "MB" basis, optional for "RB".
- **fund_codes** (list | None) - Optional - Filter by exact fund code(s)
- **fund_title_contains** (list | None) - Optional - Filter by term(s) in fund name
- **save_to_excel** (bool) - Optional - Defaults to `False`. If `True`, saves result to `.xlsx`

### Returns
`pandas.DataFrame` with columns varying based on the `basis` parameter. See documentation for specific column details for "RB", "SB", and "MB" bases.

### Request Example
```python
from tefasfon import get_returns

# Return-based (standard periods)
df = get_returns(
    fund_type="ETF",
    basis="RB",
)

# Return-based (specific date range)
df = get_returns(
    fund_type="PEN",
    basis="RB",
    start_date="01.04.2026",
    end_date="30.04.2026",
)

# Size-based
df = get_returns(
    fund_type="RE",
    basis="SB",
    start_date="01.04.2026",
    end_date="30.04.2026",
)

# Management fee-based
df = get_returns(
    fund_type="SEC",
    basis="MB",
    start_date="01.04.2026",
    end_date="30.04.2026",
)
```
```

--------------------------------

### tefasfon CLI: Fetch ETF Funds by Title Keyword as JSON

Source: https://pypi.org/project/tefasfon

Retrieve Exchange-Traded Fund (ETF) data, filtering by a keyword in the fund title, and output the results in JSON format.

```bash
tefasfon funds -t ETF -s 01.04.2026 -e 30.04.2026 -f ALTIN -o json
```

--------------------------------

### tefasfon CLI - Return Data

Source: https://pypi.org/project/tefasfon

Fetches return data using the tefasfon CLI. Supports filtering by fund type, date range, and return basis. Can save output to Excel or print to stdout in CSV or JSON format.

```APIDOC
## tefasfon returns

### Description
Fetches return data from the TEFAS website.

### Method
CLI Command

### Endpoint
N/A (CLI tool)

### Parameters
#### Common Options
- **-t, --fund-type** (str) - Required - Fund type (SEC, PEN, ETF, RE, VC)
- **-b, --basis** (str) - Required - Return basis (RB, SB, MB)
- **-s, --start-date** (str) - Optional - Start date in DD.MM.YYYY format (required for SB and MB)
- **-e, --end-date** (str) - Optional - End date in DD.MM.YYYY format (required for SB and MB)
- **-x, --save-to-excel** - Optional - Save result to .xlsx file
- **-o, --output** (csv | json) - Optional - Print to stdout in CSV or JSON format

### Request Example
```bash
tefasfon returns -t SEC -b RB -x
tefasfon returns -t PEN -b RB -s 01.04.2026 -e 30.04.2026 -o csv
tefasfon returns -t RE -b SB -s 01.04.2026 -e 30.04.2026 -x
```

### Response
Output is typically a pandas DataFrame saved to Excel, or printed to stdout as CSV or JSON.
```

--------------------------------

### get_portfolio

Source: https://pypi.org/project/tefasfon

Fetches portfolio breakdown by date range and fund type. Allows filtering by fund codes or names and optionally saves the result to an Excel file.

```APIDOC
## get_portfolio

### Description
Fetches portfolio breakdown by date range and fund type. Allows filtering by fund codes or names and optionally saves the result to an Excel file.

### Parameters
#### Query Parameters
- **fund_type** (str) - Required - Type of fund: "SEC" Securities, "PEN" Pension, "ETF" Exchange-Traded Fund, "RE" Real Estate, "VC" Venture Capital
- **start_date** (str) - Required - Start date in `DD.MM.YYYY` format
- **end_date** (str) - Required - End date in `DD.MM.YYYY` format
- **fund_codes** (list | None) - Optional - Filter by exact fund code(s)
- **fund_title_contains** (list | None) - Optional - Filter by term(s) in fund name
- **save_to_excel** (bool) - Optional - Defaults to `False`. If `True`, saves result to `.xlsx`

### Returns
`pandas.DataFrame` with columns including `fonKodu`, `fonUnvan`, `tarih`, and various asset allocation percentages.

### Request Example
```python
from tefasfon import get_portfolio

df = get_portfolio(
    fund_type="PEN",
    start_date="01.04.2026",
    end_date="30.04.2026",
)
```
```

--------------------------------

### Fetch Portfolio Breakdown by Date Range

Source: https://pypi.org/project/tefasfon

Use this function to retrieve a detailed breakdown of a fund's portfolio composition within a specified date range. It returns a pandas DataFrame with various asset class percentages.

```python
from tefasfon import get_portfolio

df = get_portfolio(
    fund_type="PEN",
    start_date="01.04.2026",
    end_date="30.04.2026",
)
```

--------------------------------

### analyze_funds

Source: https://pypi.org/project/tefasfon/1.1.0

Calculates performance metrics from a DataFrame obtained from `get_funds()`. It returns a DataFrame sorted by Sharpe ratio in descending order.

```APIDOC
## analyze_funds

### Description
Calculates performance metrics from a `get_funds()` DataFrame. The function returns a pandas DataFrame sorted by Sharpe ratio (descending).

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Parameters
- **df** (`pd.DataFrame`) - Required - Output of `get_funds()`
- **price_col** (`str`) - Optional - Default: `"fiyat"` - Price column
- **fund_code_col** (`str`) - Optional - Default: `"fonKodu"` - Fund code column
- **fund_title_col** (`str`) - Optional - Default: `"fonUnvan"` - Fund name column
- **date_col** (`str`) - Optional - Default: `"tarih"` - Date column
- **freq** (`str`) - Optional - Default: `"D"` - Return frequency: `D` `B` `W` `M` `Q` `A`/`Y`
- **risk_free_annual** (`float`) - Optional - Default: `0.0` - Annual risk-free rate (e.g. `0.10` = 10%)
- **periods_per_year** (`int | None`) - Optional - Default: `None` - Inferred from `freq` if not set
- **method** (`str`) - Optional - Default: `"simple"` - `
```

--------------------------------

### tefasfon CLI - Funds Command

Source: https://pypi.org/project/tefasfon/1.1.0

Fetches general fund information using the 'funds' command. Supports filtering by type, date range, fund codes, and title keywords. Can output to Excel, CSV, or JSON.

```APIDOC
## tefasfon funds

### Description
Fetches general fund information from the TEFAS website.

### Method
CLI Command

### Endpoint
N/A (CLI Tool)

### Parameters
#### Common Options
- **-t, --fund-type** (str) - Required - Type of fund (SEC, PEN, ETF, RE, VC)
- **-s, --start-date** (str) - Required - Start date in DD.MM.YYYY format
- **-e, --end-date** (str) - Required - End date in DD.MM.YYYY format
- **-c, --fund-codes** (list) - Optional - Filter by specific fund code(s)
- **-f, --fund-title-contains** (list) - Optional - Filter by keywords in fund title
- **-x, --save-to-excel** - Optional - Save result to an Excel file (.xlsx)
- **-o, --output** (str) - Optional - Output format (csv or json)

### Request Example
```bash
tefasfon funds -t SEC -s 01.04.2026 -e 30.04.2026 -x
tefasfon funds -t PEN -s 01.04.2026 -e 30.04.2026 -c AEK AEY -o csv
tefasfon funds -t ETF -s 01.04.2026 -e 30.04.2026 -f ALTIN -o json
```

### Response
Output is typically printed to stdout or saved to a file, depending on the options used. The structure depends on the output format (CSV, JSON, or Excel).
```

--------------------------------

### tefasfon CLI - General Fund Information

Source: https://pypi.org/project/tefasfon

Fetches general fund information using the tefasfon CLI. Supports filtering by fund type, date range, fund codes, and fund titles. Can save output to Excel or print to stdout in CSV or JSON format.

```APIDOC
## tefasfon funds

### Description
Fetches general fund information from the TEFAS website.

### Method
CLI Command

### Endpoint
N/A (CLI tool)

### Parameters
#### Common Options
- **-t, --fund-type** (str) - Required - Fund type (SEC, PEN, ETF, RE, VC)
- **-s, --start-date** (str) - Required - Start date in DD.MM.YYYY format
- **-e, --end-date** (str) - Required - End date in DD.MM.YYYY format
- **-c, --fund-codes** (list) - Optional - Filter by fund code(s)
- **-f, --fund-title-contains** (list) - Optional - Filter by keyword(s) in fund title
- **-x, --save-to-excel** - Optional - Save result to .xlsx file
- **-o, --output** (csv | json) - Optional - Print to stdout in CSV or JSON format

### Request Example
```bash
tefasfon funds -t SEC -s 01.04.2026 -e 30.04.2026 -x
tefasfon funds -t PEN -s 01.04.2026 -e 30.04.2026 -c AEK AEY -o csv
tefasfon funds -t ETF -s 01.04.2026 -e 30.04.2026 -f ALTIN -o json
```

### Response
Output is typically a pandas DataFrame saved to Excel, or printed to stdout as CSV or JSON.
```

--------------------------------

### Python API - get_funds

Source: https://pypi.org/project/tefasfon/1.1.0

Fetches general fund information using the Python API. Allows filtering by fund type, date range, specific fund codes, and keywords in the fund title. Can save results to an Excel file.

```APIDOC
## get_funds

### Description
Fetches general fund information by date range and fund type using the Python API.

### Method
Python Function

### Signature
`get_funds(fund_type: str, start_date: str, end_date: str, fund_codes: list | None = None, fund_title_contains: list | None = None, save_to_excel: bool = False) -> pandas.DataFrame`

### Parameters
- **fund_type** (str) - Required - Type of fund (e.g., "SEC", "PEN", "ETF", "RE", "VC")
- **start_date** (str) - Required - Start date in DD.MM.YYYY format
- **end_date** (str) - Required - End date in DD.MM.YYYY format
- **fund_codes** (list | None) - Optional - Filter by exact fund code(s). Defaults to None.
- **fund_title_contains** (list | None) - Optional - Filter by term(s) in fund name. Defaults to None.
- **save_to_excel** (bool) - Optional - If True, saves the result to an `.xlsx` file. Defaults to False.

### Returns
- **pandas.DataFrame** - A DataFrame containing fund data with columns like `fonKodu`, `fonUnvan`, `tarih`, `fiyat`, etc.

### Example
```python
from tefasfon import get_funds

df = get_funds(
    fund_type="SEC",
    start_date="01.04.2026",
    end_date="30.04.2026",
)

df = get_funds(
    fund_type="PEN",
    start_date="01.04.2026",
    end_date="30.04.2026",
    fund_codes=["AEK", "AEY"],
)

df = get_funds(
    fund_type="ETF",
    start_date="01.04.2026",
    end_date="30.04.2026",
    fund_title_contains=["ALTIN", "GÜMÜŞ"],
)
```
```

--------------------------------

### analyze_funds

Source: https://pypi.org/project/tefasfon

Calculates performance metrics from a DataFrame containing fund data. It allows customization of price columns, fund identifiers, date columns, return frequency, risk-free rate, and calculation method.

```APIDOC
## analyze_funds

### Description
Calculates performance metrics from a `get_funds()` DataFrame. This function is useful for analyzing the performance of various investment funds based on historical data.

### Parameters
#### Parameters
- **df** (`pd.DataFrame`) - Required - Output of `get_funds()`
- **price_col** (`str`) - Optional - Default: `"fiyat"` - Price column name.
- **fund_code_col** (`str`) - Optional - Default: `"fonKodu"` - Fund code column name.
- **fund_title_col** (`str`) - Optional - Default: `"fonUnvan"` - Fund name column name.
- **date_col** (`str`) - Optional - Default: `"tarih"` - Date column name.
- **freq** (`str`) - Optional - Default: `"D"` - Return frequency: `D` (Daily), `B` (Business Day), `W` (Weekly), `M` (Monthly), `Q` (Quarterly), `A`/`Y` (Annually).
- **risk_free_annual** (`float`) - Optional - Default: `0.0` - Annual risk-free rate (e.g., `0.10` for 10%).
- **periods_per_year** (`int | None`) - Optional - Default: `None` - Number of periods per year. Inferred from `freq` if not set.
- **method** (`str`) - Optional - Default: `"simple"` - Calculation method: `"simple"` or `"log"`.
- **drop_empty** (`bool`) - Optional - Default: `True` - Whether to drop funds with insufficient data.

### Returns
`pandas.DataFrame` sorted by Sharpe ratio (descending).

#### Columns
- **Fund Code** (`str`) - The unique code for the fund.
- **Fund Name** (`str`) - The name of the fund.
- **Observations** (`int`) - The number of return observations available.
- **Cumulative Return** (`float`) - The total return over the specified period.
- **Annualized Return** (`float`) - The annualized return of the fund.
- **Annualized Volatility** (`float`) - The annualized standard deviation of the fund's returns.
- **Sharpe Ratio** (`float`) - The risk-adjusted return, annualized.

### Example
```python
from tefasfon import get_funds, analyze_funds

df = get_funds(
    fund_type="SEC",
    start_date="01.01.2026",
    end_date="30.04.2026",
)

metrics = analyze_funds(
    df,
    freq="B",
    method="log",
    risk_free_annual=0.40,
)

print(metrics)
```
```

--------------------------------

### tefasfon Python API - get_funds

Source: https://pypi.org/project/tefasfon

Fetches general fund information using the Python API. Supports filtering by fund type, date range, fund codes, and fund titles. Returns a pandas DataFrame.

```APIDOC
## get_funds

### Description
Fetches general fund information by date range and fund type using the Python API.

### Method
Python Function

### Endpoint
N/A (Python function)

### Parameters
#### Parameters
- **fund_type** (str) - Required - Fund type (SEC, PEN, ETF, RE, VC)
- **start_date** (str) - Required - Start date in DD.MM.YYYY format
- **end_date** (str) - Required - End date in DD.MM.YYYY format
- **fund_codes** (list | None) - Optional - Filter by exact fund code(s). Defaults to None.
- **fund_title_contains** (list | None) - Optional - Filter by term(s) in fund name. Defaults to None.
- **save_to_excel** (bool) - Optional - Save result to .xlsx file. Defaults to False.

### Request Example
```python
from tefasfon import get_funds

df = get_funds(
    fund_type="SEC",
    start_date="01.04.2026",
    end_date="30.04.2026",
)

df = get_funds(
    fund_type="PEN",
    start_date="01.04.2026",
    end_date="30.04.2026",
    fund_codes=["AEK", "AEY"],
)

df = get_funds(
    fund_type="ETF",
    start_date="01.04.2026",
    end_date="30.04.2026",
    fund_title_contains=["ALTIN", "GÜMÜŞ"],
)
```

### Response
#### Success Response
- **pandas.DataFrame**: A DataFrame containing fund data.

#### Columns
- **fonKodu** (str) - Fund code
- **fonUnvan** (str) - Fund name
- **tarih** (str) - Date
- **fiyat** (float) - Price
- **tedPaySayisi** (int) - Number of shares in circulation
- **kisiSayisi** (int) - Number of investors
- **portfoyBuyukluk** (float) - Portfolio size (TRY)
- **borsaBultenFiyat** (float) - Exchange bulletin price
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.