frequently asked questions

Ask us anything. We answer plainly.

If your question isn’t here, email info@histone.com.pk and we’ll answer it — and probably add it to this page.

The basics

What is PSXfolio?

A portfolio tracker, watchlist and market tracker for the Pakistan Stock Exchange. You record what you bought and sold; it tracks your positions, P&L, dividends and corporate actions against live PSX prices, and gives you a screener, smart watchlists, charts and alerts for the rest of the market.

Is PSXfolio free?

Yes — free, with no ads and no locked features. If a paid tier is ever introduced, everything described on this site stays free.

Is PSXfolio the official Pakistan Stock Exchange app?

No. PSXfolio is an independent app by Histone and is not affiliated with or endorsed by the Pakistan Stock Exchange Limited. It uses the market data PSX publishes on its public data portal.

Which platforms does it run on?

Android (8.0 and up) today. An iOS version is planned. There is no web version — keeping your data on one device you control is the point.

How do I get the app?

It’s in early access ahead of the Google Play release. Email info@histone.com.pk and we’ll send you the Android build.

Do I need an account or phone number to use it?

No. There is no signup, login, or account of any kind. Install it and start recording trades.

Is it beginner-friendly, or is it for experienced traders?

Both, deliberately. Defaults are simple — a clean daily line chart, plain portfolio totals — and depth appears only when you reach for it: indicator panes, fee engines, cash ledgers, TWR/XIRR analytics, rule-based lists. Beginners aren’t overwhelmed; experts aren’t shortchanged.

Portfolios & orders

Can I keep more than one portfolio?

Yes — as many as you like, each with its own fee preset, cash setting and history. The Home tab shows the combined value with an allocation breakdown by portfolio and by stock.

I’ve been investing for years. Can I enter my old trades?

Yes. Orders can be recorded on any past date, and the math replays chronologically, so your average costs, realized P&L and performance history come out right. For a long history, the CSV import is faster than tapping orders in one by one.

How is my average cost calculated?

Weighted-average cost, with brokerage fees capitalized into the position — the same convention your broker’s statement uses. Selling books realized P&L against that average.

Does it handle brokerage fees?

Yes. Each portfolio has a fee preset — fixed, percentage, or fixed-below-a-threshold-then-percent, set separately for buys and sells. Every order form prefills from the preset and stays editable for the odd exception.

What is cash tracking, and do I have to use it?

It’s optional, per portfolio. Switched on, the portfolio keeps a cash ledger — deposits, withdrawals, order settlements, dividend credits — plus a statement view. Switched off, PSXfolio just tracks positions. No real money moves either way; it’s a record.

I entered an order wrong. Can I fix it?

Yes. Open History, tap the entry to edit it, or delete it — holdings and P&L recalculate automatically either way.

Can I import my history from a spreadsheet, or export my data?

Both. Orders import from CSV and export back to CSV, and Settings → Backup exports the entire database — portfolios, dividends, watchlists, alerts, everything — to a single file.

Dividends & corporate actions

How do I record a dividend?

Enter the announced rate in rupees per share; your share count prefills from the holding and withholding tax is deducted to give the net amount. If cash tracking is on, the net credits your cash balance. When an announced payout goes ex while you hold the stock, the Home tab reminds you — recording it is one tap.

Does it handle withholding tax on dividends?

Yes — the entry form applies withholding tax (defaulting to the filer rate of 15%) and you can adjust the rate per entry if your status differs. Summaries show dividends net of tax.

Can it project my dividend income?

The dividend calendar shows projected annual income — gross, net and yield — based on declared payouts for the stocks you hold, plus upcoming ex-dates with your payout amounts and a history of what you’ve received. It sticks to announced facts rather than speculative forecasts.

How do bonus shares, rights issues and splits work?

Record the action against your holding — bonus percentage, rights price and quantity, or split ratio — and PSXfolio replays it chronologically through your cost basis, showing a before/after preview before saving. Share counts, average cost, and (for rights) cash all stay consistent.

Do corporate actions mess up my P&L history?

No — that’s the reason they’re first-class entries rather than manual adjustments. Because actions are replayed in date order alongside your trades, your average cost and realized P&L remain correct even when you add an action you’d forgotten about.

Market data

Where do prices come from?

From the Pakistan Stock Exchange’s public data portal — the same source as the exchange’s own website. That covers live quotes for 500+ listed symbols, the major indices, fundamentals, corporate payouts, and company announcements.

Are prices real-time?

They refresh about every 5 minutes during market hours, which is the cadence the PSX portal publishes at. That’s ideal for investors tracking a portfolio; if you scalp intraday moves second-by-second, your broker terminal is the right tool for that job.

Which stocks and indices are covered?

Every regular-market equity listed on PSX — 500+ symbols — plus the headline indices including the KSE-100. Fundamentals (P/E, dividend yield, P/B, market cap, 52-week range) are refreshed on a rolling daily sweep.

Does the app work offline?

Your portfolio, history and records are always available offline — they live on the device. Prices, charts and news need a connection and resume automatically when you’re back online.

What happens when the market is closed?

The app shows the last session’s prices with a clear “market closed” state, and the feed checks in at a slower cadence until the next session. PSX trading holidays are picked up from the exchange calendar.

Do you show bid/offer depth or order books?

No. The public portal doesn’t publish depth, so we don’t pretend to have it. You get price, change, volume, open/high/low/close and history — honest data, honestly labeled.

Watchlists, screener & alerts

What makes a watchlist “smart”?

You can attach rules to any list — like “P/E ≤ 5”, “YoY return ≥ 10%”, “within 25% of the 52-week low”, a sector, or Shariah-only — and the list fills itself, re-evaluating on every price update. You see a live match preview while editing the rules, and you can still pin stocks manually.

Can I get notified when a stock starts (or stops) matching my criteria?

Yes — each smart list has an optional enter/exit alert with a 30-minute cooldown, so a price flickering around your threshold can’t flood you with notifications. Entries and exits also land in the Alerts tab’s activity feed.

What can price alerts trigger on?

Price, day change %, volume, P/E, dividend yield, P/B, or market cap — crossing above or below your level. A fired alert notifies you once and switches itself off; re-arm it with a tap when you want it live again.

Will alerts fire if the app is closed?

Alerts are evaluated on your device against the live feed and fire as local notifications — there’s no server watching on your behalf, because your data never goes to one. In practice: they fire while the app is running (including in the background); if Android has fully stopped the app for a long time, checks resume when you next open it.

What is the day-end digest?

One notification after market close summarising each portfolio’s value and day change — a calm alternative to checking prices all day. Toggle it in Settings.

Can I add a whole screener result to a watchlist?

Yes — “Watch all” adds every current match in one tap, and “Unwatch all” reverses it. Handy for building a candidate list you then prune by hand.

Shariah

How does the Shariah screening work?

A stock is badged compliant when it’s included in the PSX’s KMI (KSE-Meezan Index) screen — the classification the exchange itself publishes, developed with Al-Meezan and its Shariah board. The badge appears on stock pages and lists, the screener has a Shariah-only toggle, and smart watchlists can carry compliance as a standing rule.

Is the badge a religious ruling?

No — it reflects the exchange’s published KMI classification, nothing more. PSXfolio doesn’t issue its own rulings, and doesn’t currently compute purification amounts or zakat. For personal religious guidance, consult a scholar.

Can I make sure I only ever see halal stocks?

You can keep the screener on Shariah-only and give every smart watchlist a compliance rule, so nothing non-compliant enters your lists. Market-wide screens (like the movers) still show the whole exchange.

Privacy & backup

Where is my portfolio data stored?

In a SQLite database on your phone. Portfolios, orders, dividends, corporate actions, watchlists, alerts and settings never leave the device. There is no account, so there is no server-side copy anywhere.

Can you see my holdings?

No. The app’s only network traffic is fetching market data — quotes, charts, announcements. What you own, what you paid, and what you’re watching stays on your device.

How do I move to a new phone?

Settings → Backup & restore exports everything to a single file. Move the file (any way you like — it’s yours) and restore it on the new device.

What happens if I uninstall the app?

The database is deleted with it — that’s the flip side of nothing living in the cloud. Export a backup first; it takes seconds.

Is there cloud sync between devices?

Not today. Cross-device transfer is via the backup file. If sync ever arrives, it will be opt-in and won’t change the default: local first.

Trading & brokers

Can I buy or sell shares through PSXfolio?

No. PSXfolio is a tracker, not a brokerage — it can’t place, route or execute orders, and nothing you enter is ever sent to a broker. To trade, use a PSX TREC-holding broker; to know exactly how you’re doing, use PSXfolio.

Does it import trades from my broker or CDC account automatically?

No — there are no broker or CDC logins, by design. You record trades yourself or import a CSV. That one manual step is what buys total privacy: no credentials to store, no third party with your positions.

Which brokers does it work with?

All of them, in the way that matters: since you record your own trades, it doesn’t care where you executed them. It’s one place to see positions spread across multiple brokers.

Does PSXfolio give stock tips or investment advice?

No. It computes your numbers and shows the market’s — prices, fundamentals, announcements, your own P&L. No recommendations, no signals, no advice.

Still have a question?

Email us — real answers, usually within a day.

info@histone.com.pk