Connect Fintables: Borsa, Hisse ve Fon to your stack — quotes, balance sheets, funds and portfolios
Fintables is the Turkish-market analytics surface trusted by retail investors and a growing set of institutional desks across Borsa Istanbul. We deliver protocol analysis, account login flows, watchlist sync, balance-sheet ratio pulls, fund-comparison endpoints and Excel/JSON exports. Every integration is shaped to OpenData and OpenFinance patterns so the data plugs straight into back offices, BI dashboards and risk engines.
What we deliver
Deliverables checklist
- OpenAPI 3.1 specification covering quotes, statements, funds and watchlists
- Protocol & auth flow report (token chain, refresh, request signing, anti-bot headers)
- Runnable Python and Node.js source for login, balance-sheet pulls and fund comparison
- Pytest / Vitest suite with golden BIST tickers (e.g. THYAO, ASELS, KCHOL) for regression
- KVKK and SPK-aligned consent text plus a data-retention checklist
- One-page architecture diagram and an Excel/CSV export sample for finance teams
Two engagement models
Pick whichever fits your procurement style. Both ship with the same code quality and the same compliance review.
- Source-code delivery from $300 — receive runnable API source code, OpenAPI spec, tests and docs; pay only after delivery and your acceptance test.
- Pay-per-call API billing — call our hosted Fintables proxy and pay per request with no upfront fee. Ideal for experimentation, pilots and seasonal flows.
Data available for integration
The table below maps the Fintables surfaces we have profiled to integration-ready endpoints. All rows are derived from features the app exposes today, and each one has an OpenData / OpenFinance angle that downstream teams routinely ask for. We deliver only the rows you sign off on; nothing is scraped from screens that require additional brokerage permission.
| Data type | Source surface | Granularity | Typical downstream use |
|---|---|---|---|
| BIST equity quotes | "Live stock market" tab, ticker detail | Real-time tick / 1-min bar / daily close | Algorithmic dashboards, retail aggregators, risk monitors |
| Balance-sheet ratios | Stock fundamentals screen | Quarterly / annual per ticker | Fundamental screening, credit research, ESG overlays |
| Dividend history | Dividend & new-business screens | Per ticker · per ex-date | Income-investing models, accountant year-end reports |
| Mutual & pension funds | Fund analysis & comparison | Per fund · daily NAV · weekly/monthly returns | Robo-advisor scoring, PFM tools, distributor reporting |
| Fintables Report Card | Score card screen | Per ticker · profitability/growth/debt vectors | Quant factor blends, fintech newsletters, lead lists |
| KAP news & sector feed | News feed with filters | Per ticker · per timestamp | Event-driven trading, compliance archives, NLP pipelines |
| Watchlists & price alerts | User profile & alerts | Per user · per rule | CRM personalisation, notification gateways |
| Virtual portfolio rows | Portfolio screen | Position-level · cash & instruments | Net-worth tracking, tax-lot reporting, advisor dashboards |
| Economic agenda | Macro calendar | Per event · per release date | Macro rooms, content calendars, push-notification engines |
Typical integration scenarios
The Turkish retail-investor base has roughly tripled since 2020, and Fintables sits at the centre of that long-tail demand. Below are five scenarios we have shipped or scoped against the app's data surface. Each one names the specific endpoints involved and the OpenData / OpenFinance pattern it folds into.
1. BIST tick aggregator for a multi-asset dashboard
A wealth-tech client wanted BIST prices side-by-side with NASDAQ and crypto in a single dashboard. We exposed Fintables quote pulls behind /v1/quote and /v1/quote/stream with a server-sent-events bridge, and shipped a normalised symbol map (BIST THYAO.E → ISO MIC XIST). This is OpenData in the truest sense: read-only, cache-friendly, and ready for fan-out to thousands of viewers.
2. Robo-advisor fund scoring for pension distributors
A pension distributor scored every Turkish fund weekly using AUM, return decile and portfolio composition. We wired the Fintables fund-comparison view into /v1/fund/score?period=12M, returning Sharpe, max drawdown and concentration ratios per fund. The scoring engine ran nightly under SPK-aligned product-suitability rules.
3. Fundamental-analysis pipeline for an asset manager
An Istanbul-based boutique fund wanted balance-sheet ratios for the BIST 100 universe in a parquet warehouse. We built /v1/fundamentals/{ticker} with quarterly history back to 2018, plus a back-fill job that paginates through Fintables responses, normalises Turkish accounting terms, and writes into S3. Result: 60-second factor refreshes instead of analyst spreadsheets.
4. KAP news capture for compliance archives
A bank's surveillance team needed every KAP disclosure for monitored tickers in a tamper-evident store. We tapped the Fintables filtered news feed, deduplicated against KAP's own RSS, and pushed signed JSON into the bank's WORM bucket. This is OpenFinance-adjacent: regulated read-only flows with full provenance.
5. Virtual-portfolio export to a tax tool
An accountant network wanted clients' Fintables virtual portfolios re-emerging as Turkish-tax-compliant CSVs. With explicit user consent we pulled the portfolio rows, computed weighted-average cost per lot, applied dividend stripping rules, and produced a download endpoint that the accountants forwarded to e-Beyanname workflows.
Technical implementation
Below are three representative request/response shapes we deliver. Field names follow Fintables' own JSON conventions where they exist; everything else is normalised to an internal OpenAPI 3.1 schema so consumers do not have to track Turkish-only labels.
Login & token refresh (OAuth-style proxy)
POST /api/v1/fintables/login
Content-Type: application/json
{
"username": "user@example.com",
"password": "<encrypted>",
"device_id": "ios-2A8F"
}
200 OK
{
"access_token": "eyJhbGciOi...",
"refresh_token": "rt_9c3...",
"expires_in": 3600,
"user_id": "u_412987"
}
Balance-sheet ratios for one ticker
GET /api/v1/fintables/fundamentals/THYAO?period=2024Q4
Authorization: Bearer <ACCESS_TOKEN>
200 OK
{
"ticker": "THYAO",
"period": "2024Q4",
"net_profit_try": 70_120_000_000,
"sales_try": 350_900_000_000,
"equity_try": 410_500_000_000,
"pe": 4.6,
"pb": 1.1,
"debt_to_equity": 1.42,
"report_card": { "profit": 87, "growth": 71, "debt": 64 }
}
Fund comparison webhook payload
POST https://your-app.example.com/webhooks/fintables/funds
X-OFL-Signature: sha256=...
{
"event": "fund.compare.completed",
"occurred_at": "2026-05-03T08:14:22Z",
"basket": ["TGE","ICD","AFA"],
"metrics": {
"TGE": {"return_1y": 0.342, "aum_try": 8_120_000_000},
"ICD": {"return_1y": 0.298, "aum_try": 4_710_000_000},
"AFA": {"return_1y": 0.276, "aum_try": 1_980_000_000}
}
}
Errors follow RFC 7807 problem+json with a stable code field (e.g. FT-401-TOKEN-EXPIRED, FT-429-RATE-LIMIT, FT-503-UPSTREAM-DOWN) so client retries can be deterministic.
Compliance & privacy
Regulatory alignment
Fintables sits inside Turkey's capital-markets perimeter. We align integrations with the Capital Markets Board of Turkey (SPK / CMB), the data-protection rules of KVKK (Turkey's GDPR analogue), and where personal financial data is involved, the BDDK Open Banking framework. The 28 March 2025 amendments that introduced ÖHVPS 2.0 are explicitly part of our review checklist when account information from banks is in scope.
Privacy posture
We log only metadata required for billing and abuse detection, never raw personal identifiers. Tokens are stored under HSM-wrapped keys, every call carries a consent trace, and customers can request a one-click revoke that propagates to all downstream caches. NDAs and data-processing addenda are available before any code touches production.
Data flow / architecture
The reference pipeline is intentionally simple, so it can be audited and reproduced:
- Client App / Browser — your dashboard, robo-advisor or accounting tool calls the OpenFinance Lab gateway with a consented user token.
- Ingestion / API gateway — request signing, rate limiting (default 5 rps per user, burst 20), schema validation against the OpenAPI 3.1 contract.
- Fintables protocol adapter — handles login refresh, anti-bot headers, retry/backoff and Turkish-language field translation.
- Storage & analytics — Postgres for hot reads, S3-compatible object store for raw payloads, optional ClickHouse rollups for BIST quote history and fund returns.
- Outbound — REST, webhooks, scheduled Excel/CSV drops or Snowflake/BigQuery shares.
Market positioning & user profile
Fintables was founded in 2019 in response to the explosion of retail investors on Borsa Istanbul, and according to public app-intelligence sources crossed 144,000+ active users while continuing to grow weekly revenue through Q1 2025. Its user profile skews toward Turkish retail and prosumer investors aged 25–45, with a meaningful tail of independent advisors, family-office analysts and Turkish-diaspora investors abroad. The app ships on Android and iOS with feature parity, and recently extended into direct brokerage integration so users can place trades on Borsa Istanbul without leaving the screen — a 2024-era addition that materially expands the OpenFinance surface and is one of the headline reasons clients now ask for richer back-office integrations on top of Fintables data.
Screenshots
Every screen below maps to one or more endpoints in the integration plan; click any thumbnail to open a larger view.
Similar apps & integration landscape
Fintables does not exist in a vacuum. Turkish retail investors typically combine it with one or more of the following platforms — and teams that build aggregators or back-office tools usually want unified pipes that span every name in this list. Each app holds its own slice of OpenData, so we frame them here as part of the broader ecosystem rather than ranking them.
Investing.com: Stock Market
A global markets app with broad BIST coverage. Holds watchlists, alerts and macro calendar items; teams that already export Investing.com data often want Fintables fundamentals merged in for a Turkey-only deep dive.
Matriks Mobil IQ: Borsa Döviz
Long-running Turkish trading terminal with depth-of-book and FX. Customers who run Matriks for execution frequently use Fintables for fundamentals, so unified transaction-plus-fundamental exports are a recurring request.
ForInvest: Piyasa Analizi
Real-time BIST quotes and analytical screens, popular with active traders. ForInvest data plus Fintables Report Card scores is a common combination for momentum-meets-quality strategies.
HisseChat
A community-led BIST discussion app that surfaces social sentiment. Pairing HisseChat sentiment with Fintables fundamentals creates a useful sentiment-vs-fundamentals overlay for content publishers.
Gedik Trader
Brokerage-branded trading app from Gedik Yatırım. When clients want order-routing on top of Fintables analytics, a Gedik Trader bridge is a frequent piece of the architecture.
TradingView
The most-grossing finance Android app in Turkey. Most cross-market dashboards already speak TradingView; Fintables fills the Turkish-language fundamental gap that TradingView under-indexes.
Sharesight
Multi-broker portfolio tracker with documented BIST support across hundreds of stocks and ETFs. Users who already feed BIST trades into Sharesight commonly request Fintables dividend and balance-sheet enrichment.
İş Yatırım (TradeMaster)
One of Turkey's largest brokerage trading platforms. Bank-owned brokerages typically need Fintables analytics behind their own UI for product-suitability and content marketing.
Oyak Yatırım
Another major Turkish broker with its own trading and research apps. Integration partners often want a normalised fundamentals layer (Fintables) that sits across both Oyak and other broker stacks.
Portseido
Cross-border portfolio tracker covering 160+ countries. Useful when a Turkish investor's portfolio is multi-currency and Fintables-sourced TRY data needs to merge with USD/EUR positions.
About OpenFinance Lab
We are an independent technical-services studio focused on App interface integration and authorized API integration. The team mixes engineers who have shipped at Turkish and EU banks, payment gateways and BI vendors, with a long history of protocol analysis on iOS and Android. Our outputs are always production-grade: OpenAPI specs, runnable source, regression tests, deployment scripts and a written compliance review.
- Fintech, capital markets, payments and reconciliation pipelines
- Custom Python / Node.js / Go SDKs and ready-to-import OpenAPI bundles
- End-to-end pipeline: protocol analysis → build → validation → compliance handover
- Source-code delivery from $300 — runnable API source plus full documentation, paid only after acceptance.
- Pay-per-call API billing — call our hosted endpoints with no upfront fee.
Contact
For quotes or to submit your target app and requirements, please use our contact page. We typically respond within one Istanbul business day.
Engagement workflow
- Scope confirmation: which Fintables surfaces, expected QPS, retention window, regions of users.
- Protocol analysis and OpenAPI design (2–5 business days).
- Build and internal validation against golden BIST tickers and funds (3–8 business days).
- Documentation, OpenAPI bundle, sample notebooks and an Excel export demo (1–2 business days).
- Typical first delivery: 5–15 business days. Brokerage approvals or KVKK reviews may extend timelines.
FAQ
What do I need to provide to start a Fintables integration?
How long does a first delivery take?
How do you stay compliant with Turkish capital markets rules?
Can the integration cover both Borsa Istanbul stocks and investment funds?
📱 Original app overview (appendix)
Fintables: Borsa, Hisse ve Fon is a Turkish-market investment companion that puts every tool a retail or prosumer investor needs into a single mobile surface. The app's positioning is straightforward: shape investment decisions with data, not gut feel.
- Live stock market data — Borsa Istanbul intraday prices, index movement and stock-level analytics.
- Stock analysis & balance sheets — fundamental and technical methods, with ratios such as net profit, sales, equity profitability, debt ratios, P/E and PD/DD.
- Stock tracking & buy-sell transactions — integrate an investment account and trade directly on Borsa Istanbul; build watchlists, set price alerts and follow ticker-level developments.
- Fund analysis & comparison — investment funds and individual pension funds with returns, portfolio structure, investor counts and AUM, plus a "Competitor Analysis" feature.
- Fintables Report Card — score companies on profitability, growth and debt across the entire universe at a glance.
- Fintables News Feed — KAP disclosures and sector news, filtered down to the companies you actually own.
- New business relations & dividends — track new commercial deals, their sales impact, and compare dividend yields and historical payments.
- Virtual portfolio & economic agenda — manage a virtual portfolio in one screen and follow macro release dates and announcements.
- Yield analysis & personalized alerts — compare weekly, monthly, quarterly and annual returns and create live price and KAP alerts.
Contact for the original app: fintables@fintables.com. This page exists to illustrate technical integration positioning around the Fintables surface; we do not represent the app's publisher.