Tefas API
TEFAS ve BEFAS Veri API; Türkiye Elektronik Fon Alım Satım Platformu (TEFAS) ve BEFAS altyapılarından elde edilen kapsamlı finansal verileri modern ve yüksek performanslı bir API aracılığıyla sunar. API; fon bazlı detaylar, tarihsel performans verileri, getiri oranları, portföy büyüklükleri, işlem hacimleri ve kurum bazlı raporlar gibi geniş bir veri setini kapsar. TEFAS servisleri üzerinden…
Tefas API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Trading Reports | ||
| GET |
/api/v1/funds-reports/fund-count-by-fund-type /api/v1/funds-reports/fund-count-by-fund-type |
Retrieves TEFAS fund count statistics by fund type with year/month/week granularity. **TEFAS (Türkiye Elektronik Fon Alım Satım Platformu)** - Turkish Electronic Fund Trading… |
| GET |
/api/v1/funds-reports/trading-institutions /api/v1/funds-reports/trading-institutions |
Retrieves statistics about institutions that trade in TEFAS funds. **Data Source:** TEFAS (Turkish Electronic Fund Trading Platform) **API Endpoint:**… |
| GET |
/api/v1/funds-reports/member-based-transaction-volume /api/v1/funds-reports/member-based-transaction-volume |
Retrieves member-based transaction volume report showing trading activity by institutions and member types within TEFAS funds. **Enhanced Features:** - Supports both scraped data… |
| GET |
/api/v1/funds-reports/fund-based-transaction-volume /api/v1/funds-reports/fund-based-transaction-volume |
Retrieves TEFAS fund-based transaction volume data for individual funds. This endpoint reads from the PostgreSQL `tefas_fund_based_transaction_volume_report` table, populated by… |
| GET |
/api/v1/funds/periodic-top-earners /api/v1/funds/periodic-top-earners |
Retrieves periodic top earning funds data showing the best performing funds across different time periods. Data is read directly from the PostgreSQL database… |
| GET |
/api/v1/funds-reports/total-transaction-volume /api/v1/funds-reports/total-transaction-volume |
Retrieves TEFAS total transaction volume report for a specified year. **Data Source:** PostgreSQL database (`tefas_total_transaction_volume_report` table) **Update Frequency:**… |
| GET |
/api/v1/funds-reports/fund-type-based-member-stock-balances /api/v1/funds-reports/fund-type-based-member-stock-balances |
Retrieves member stock balances report grouped by fund type and institution within TEFAS funds. |
| Fund Returns | ||
| GET |
/api/v1/funds/sizes /api/v1/funds/sizes |
Retrieves fund size data by fund type with optional date filtering |
| GET |
/api/v1/funds/comparison /api/v1/funds/comparison |
Retrieves fund comparison data for management fees showing detailed fund information including management fees, performance metrics, and fund characteristics. **Fund Types (API… |
| GET |
/api/v1/funds/returns-by-date /api/v1/funds/returns-by-date |
Retrieves comprehensive fund return data for all fund types for a specific date, grouped by fund type with enhanced weekend handling capabilities. **Enhanced Weekend Date… |
| GET |
/api/v1/funds/comparison/{page} /api/v1/funds/comparison/{page} |
Retrieves fund comparison data with pagination for management fees analysis. **Fund Types (API Format):** - YAT = Menkul Kıymet Yatırım Fonları (Securities Investment Funds) -… |
| Other endpoints | ||
| GET |
/api/v1/reset /api/v1/reset |
Clears all cached data. This endpoint requires admin authentication. **Authentication Methods:** 1. **Bearer Token**: Use `Authorization: Bearer ` header 2. **X-Admin-Key… |
| GET |
/api/v1/funds/comparison/{page} /api/v1/funds/comparison/{page} |
Retrieves fund comparison data with pagination for management fees analysis. **Fund Types (API Format):** - YAT = Menkul Kıymet Yatırım Fonları (Securities Investment Funds) -… |
| GET |
/api/v1/funds /api/v1/funds |
Retrieves a list of all available funds |
| GET |
/api/v1/funds/comparison /api/v1/funds/comparison |
Retrieves fund comparison data for management fees showing detailed fund information including management fees, performance metrics, and fund characteristics. **Fund Types (API… |
| GET |
/api/v1/funds/sizes /api/v1/funds/sizes |
Retrieves fund size data by fund type with optional date filtering |
| GET |
/api/v1/funds-reports/fund-based-transaction-volume /api/v1/funds-reports/fund-based-transaction-volume |
Retrieves fund-based transaction volume report showing trading activity by fund types and individual funds within TEFAS platform |
| GET |
/api/v1/funds/periodic-top-earners /api/v1/funds/periodic-top-earners |
Retrieves periodic top earning funds data showing the best performing funds across different time periods. **Time Periods Included:** - Weekly (Haftalık) - Monthly (Aylık) -… |
| GET |
/api/v1/images /api/v1/images |
Retrieve a list of all uploaded images with their metadata. **Authentication Required:** This endpoint requires admin authentication. **Authentication Methods:** 1. **Bearer… |
| GET |
/api/v1/funds-reports/fund-type-based-member-stock-balances /api/v1/funds-reports/fund-type-based-member-stock-balances |
Retrieves member stock balances report grouped by fund type and institution within TEFAS funds |
| GET |
/api/v1/cron/jobs/{id}/executions /api/v1/cron/jobs/{id}/executions |
Retrieve execution history for a specific cron job with optional filtering. Requires admin authentication. **Authentication Methods:** 1. **Bearer Token**: Use `Authorization:… |
| GET |
/api/v1/cron/jobs/{id}/stats /api/v1/cron/jobs/{id}/stats |
Retrieve execution statistics and performance metrics for a specific cron job. Requires admin authentication. **Authentication Methods:** 1. **Bearer Token**: Use `Authorization:… |
| POST |
/api/v1/cron/jobs /api/v1/cron/jobs |
Create and schedule a new cron job for automated tasks. Requires admin authentication. **Authentication Methods:** 1. **Bearer Token**: Use `Authorization: Bearer ` header 2.… |
| GET |
/api/v1/healthz /api/v1/healthz |
Returns the health status of the API and its dependencies |
| GET |
/api/v1/cron/jobs/{id} /api/v1/cron/jobs/{id} |
Retrieve details of a specific cron job. Requires admin authentication. **Authentication Methods:** 1. **Bearer Token**: Use `Authorization: Bearer ` header 2. **X-Admin-Key… |
| GET |
/info /info |
Returns basic API information |
| GET |
/api/v1/cron/jobs /api/v1/cron/jobs |
Retrieve a list of cron jobs with optional filtering and pagination. Requires admin authentication. **Authentication Methods:** 1. **Bearer Token**: Use `Authorization: Bearer `… |
| PUT |
/api/v1/cron/jobs/{id} /api/v1/cron/jobs/{id} |
Update an existing cron job's configuration. Requires admin authentication. **Authentication Methods:** 1. **Bearer Token**: Use `Authorization: Bearer ` header 2. **X-Admin-Key… |
| DELETE |
/api/v1/cron/jobs/{id} /api/v1/cron/jobs/{id} |
Delete an existing cron job and stop its execution. Requires admin authentication. **Authentication Methods:** 1. **Bearer Token**: Use `Authorization: Bearer ` header 2.… |
| GET |
/api/v1/funds/historical/{page} /api/v1/funds/historical/{page} |
Retrieves fund historical data with pagination support for better performance with large datasets. **Fund Types:** - 1 = Menkul Kıymet Yatırım Fonları (Securities Investment… |
| GET |
/api/v1/funds-reports/member-based-transaction-volume /api/v1/funds-reports/member-based-transaction-volume |
Retrieves member-based transaction volume report showing trading activity by institutions and member types within TEFAS funds |
| GET |
/api/v1/funds-reports/total-transaction-volume /api/v1/funds-reports/total-transaction-volume |
Retrieves total transaction volume report for a specified year |
| GET |
/api/v1/funds/returns/{page} /api/v1/funds/returns/{page} |
Retrieves fund return data with pagination |
| GET |
/api/v1/funds/returns /api/v1/funds/returns |
Retrieves fund return data by fund type with optional date filtering |
| GET |
/api/v1/funds-reports/trading-institutions /api/v1/funds-reports/trading-institutions |
Retrieves statistics about institutions that trade in TEFAS funds |
| GET |
/api/v1/funds/count-by-type /api/v1/funds/count-by-type |
Retrieves statistics about the number of funds by fund type |
| GET |
/api/v1/cache-keys /api/v1/cache-keys |
Retrieves all cache keys matching the specified pattern. This endpoint requires admin authentication. **Authentication Methods:** 1. **Bearer Token**: Use `Authorization: Bearer… |
| GET |
/api/v1/funds/returns-by-date /api/v1/funds/returns-by-date |
Retrieves fund return data for all fund types for a specific date, grouped by fund type with enhanced weekend handling capabilities. **Weekend Date Handling:** - **Default… |
| GET |
/api/v1/funds/historical /api/v1/funds/historical |
Retrieves fund historical data by fund type with optional date filtering. **Fund Types:** - 1 = Menkul Kıymet Yatırım Fonları (Securities Investment Funds) - 2 = Emeklilik… |
| GET |
/api/v1/funds/companies /api/v1/funds/companies |
Retrieves a list of all portfolio management companies with their codes and names |
| GET |
/api/v1/delete-cache-by-key /api/v1/delete-cache-by-key |
Deletes a specific cache key from Redis. This endpoint requires admin authentication. **Authentication Methods:** 1. **Bearer Token**: Use `Authorization: Bearer ` header 2.… |
| GET |
/company-images/{filename} /company-images/{filename} |
Serve an image file directly. This endpoint is used to display/download images. **Authentication Required:** This endpoint requires admin authentication. **Authentication… |
| GET |
/api/v1/befas/fund-count-by-fund-type /api/v1/befas/fund-count-by-fund-type |
Retrieves BEFAS fund count statistics by fund type with optional time period filtering. **BEFAS (Bireysel Emeklilik Fonları Aracılık Sistemi)** - Individual Pension Funds… |
| GET |
/api/v1/befas/total-transaction-volume-report /api/v1/befas/total-transaction-volume-report |
Retrieves BEFAS total transaction volume report data from the Turkish Electronic Fund Trading Platform. This endpoint provides annual transaction volume analysis showing: -… |
| GET |
/api/v1/befas/fund-based-transaction-volume-report /api/v1/befas/fund-based-transaction-volume-report |
Retrieves BEFAS fund-based transaction volume report data from the Turkish Electronic Fund Trading Platform. This endpoint provides transaction volume analysis by individual… |
| GET |
/api/v1/funds/sizes/{page} /api/v1/funds/sizes/{page} |
Retrieves fund size data with pagination |
| GET |
/api/v1/befas/member-based-transaction-volume-report /api/v1/befas/member-based-transaction-volume-report |
Retrieves BEFAS member-based transaction volume report showing trading activity by institutions within the BEFAS system. **BEFAS (Bireysel Emeklilik Fonları Aracılık Sistemi)** -… |
| GET |
/api/v1/funds/{code} /api/v1/funds/{code} |
Retrieves detailed information for a specific fund |
| POST |
/api/v1/images /api/v1/images |
Upload an image file to the server. Supports common image formats (JPG, PNG, GIF, WebP). **Authentication Required:** This endpoint requires admin authentication.… |
| DELETE |
/api/v1/images/{filename} /api/v1/images/{filename} |
Delete an image file from the server storage. **Authentication Required:** This endpoint requires admin authentication. **Authentication Methods:** 1. **Bearer Token**: Use… |
Tefas API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $1.99 / month | 100 / second |
|
| ULTRA Recommended | $5.99 / month | 100 / second |
|
| MEGA | $12.99 / month | 100 / second |
|