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…
215 subscribers
9.8/10 popularity
310 ms avg latency
84% success rate
75 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
Tefas API endpoints
| Method | Endpoint | Description |
|---|---|---|
| System | ||
| GET |
/api/v1/healthz /api/v1/healthz |
Returns the health status of the API and its dependencies |
| GET |
/info /info |
Returns basic API information |
| Funds | ||
| GET |
/api/v1/funds/{code} /api/v1/funds/{code} |
Retrieves detailed information for a specific fund with optional period filtering |
| GET |
/api/v1/fund-analysis/{code} /api/v1/fund-analysis/{code} |
Retrieves detailed analysis for a single fund using Go-based scraping. **Data Source:** Direct scraping from TEFAS website using ChromeDP **Cache Strategy:** - Checks Redis cache… |
| GET |
/api/v1/funds/{code}/info /api/v1/funds/{code}/info |
Retrieves comprehensive fund information aggregated from multiple database tables in a single optimized query. **Data includes:** - Base and profile info (ISIN, Risk, Category) -… |
| GET |
/api/v1/funds/{code}/{period} /api/v1/funds/{code}/{period} |
Retrieves detailed information for a specific fund with optional period filtering |
| GET |
/api/v1/fund-info/history/{code} /api/v1/fund-info/history/{code} |
Retrieves fund historical price data from PostgreSQL database with optional pagination. **Data Source:** PostgreSQL database (fund_line_values table) **Cache Strategy:** Redis… |
| GET |
/api/v1/funds/search /api/v1/funds/search |
Searches funds with Turkish-character-friendly matching. Supports general and field-based filtering by: - Fund code (`fundCode`) - Fund name (`fundName`) - Category (`category`)… |
| POST |
/api/v1/funds/compare /api/v1/funds/compare |
Aggregates detailed data for multiple funds for comparison. Returns a flattened, optimized data structure for comparing performance, size, and management details across a list of… |
| GET |
/api/v1/funds /api/v1/funds |
Retrieves a list of all available funds |
| GET |
/api/v1/fund-info/by-date /api/v1/fund-info/by-date |
Retrieves the latest fund data for a specific date with automatic weekend handling. **Data Source:** PostgreSQL database (fund_line_values table) **Cache Strategy:** - Today's… |
| GET |
/api/v1/funds/companies /api/v1/funds/companies |
Retrieves a comprehensive list of all portfolio management companies operating in Turkey's fund market. **Data Source:** - Dynamically scraped from TEFAS website dropdown menus -… |
| GET |
/api/v1/funds/announcements /api/v1/funds/announcements |
Retrieves a list of TEFAS fund announcements with optional pagination. The system automatically extracts the announcement URL from the detail content. |
| 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) -… |
| GET |
/api/v1/funds/returns /api/v1/funds/returns |
Retrieves fund return data by fund type with optional date filtering |
| 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/funds/sizes/{page} /api/v1/funds/sizes/{page} |
Retrieves fund size data with pagination |
| GET |
/api/v1/funds/returns/{page} /api/v1/funds/returns/{page} |
Retrieves fund return data with pagination |
| GET |
/api/v1/funds/historical /api/v1/funds/historical |
Retrieves comprehensive historical fund data by fund type with flexible date filtering and enhanced performance metrics. **Fund Types (Numeric Mapping):** - 1 = Menkul Kıymet… |
| 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… |
| 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. |
| BEFAS | ||
| 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/befas/fund-based-transaction-volume-report /api/v1/befas/fund-based-transaction-volume-report |
Retrieves BEFAS fund-based transaction volume report data showing individual fund transaction volumes. This endpoint provides transaction volume analysis by individual funds,… |
| 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/fund-type-based-transaction-volume-report /api/v1/befas/fund-type-based-transaction-volume-report |
Retrieves BEFAS fund type based transaction volume report showing transaction volumes grouped by fund types. This endpoint provides transaction volume analysis by fund type… |
| GET |
/api/v1/befas/total-transaction-volume-report /api/v1/befas/total-transaction-volume-report |
Retrieves BEFAS total transaction volume report data showing total market transaction volumes. This endpoint provides transaction volume analysis showing: - Total transaction… |
| Utilities | ||
| 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… |
| 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… |
+ 25 more endpoints on the provider's documentation.
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 |
|
