Stocks Reader

A free simple stock portfolio dashboard, fully managed by the URL. Designed and tested for the Kindle browser, but should work with other e-readers.

You can bookmark the dashboard. Prices refresh automatically every 10 minutes (or press the "↻").

URL Format

The full address has two parts, all optional:

The person’s name as the path, use e.g. "Portfolio" for privacy
The list of stocks and number of shares as query parameters

https://stocksreader.com/PERSON_NAME?TICKER=SHARES&TICKER=SHARES

Example

This is a complete example you can type exactly as shown:

https://stocksreader.com/John%20Doe?%5Egspc=10&amzn=10&msft=12&tsla=8&v=15&ko=20

Person Name

The person’s name appears in the address after the first slash.

Spaces must be written as %20
Do not use raw spaces

Examples:

John%20Doe

Stocks and Shares

Stocks are written as a query parameter. Each stock is written as:

The stock ticker as seen in the URL from https://finance.yahoo.com/ (I wonder why 👀)
An equals sign
The number of shares you own

amzn=12

Multiple stocks are separated using an ampersand as usual:

amzn=12&tsla=14&meta=15

Important: Tickers Must Be Escaped

Some stock tickers contain special characters and must be written in an escaped form.

For example:

The ticker ^GSPC must be written as %5Egspc

&%5Egspc=10

If a ticker is not escaped correctly, it will not appear.

What the Page Shows

After loading the address, the page shows a summary at the top followed by a list of stock cards.

Top of the Page

The person’s name
The total value of all stocks combined, shown in dollars

This total is the sum of all individual stock values shown below.

Stock Cards

Each stock appears as its own card. Each card contains:

Stock name (top-left)
Daily percentage change (top-right)
Price × number of shares (below the name)
Total value of your position (bottom-left)
Daily value change in dollars (bottom-right)

Green values mean a gain. Red values mean a loss.

Each stock card links to its page on Yahoo Finance.

Notes

You can bookmark any address for later use
Prices update automatically
The layout is optimized for Kindle and screen readers

Questions and Answers

How do you prevent the kindle from sleeping?

It seems there's no way to keep the kindle always on natively. The longest period is 1 hour. This is... awful TBH, I didn't expect this since I assumed it'd be possible. Why would you make a device that DOESN'T USE POWER when turned on, then make it "go to sleep"? Unbelievable.

How precise is this?

Very unprecise, I'm doing a best-effort to update it from Yahoo Finance, please don't use it for anything else than a very general and vague idea of how your portfolio is doing. Specifically, do not use this to inform you of buy/sell/hold opportunities. This is not a financial website, it's a website for some quick info.

It doesn't work!

That's not really a question:)

There's many reasons why it could not be working. Some are about me or my server being down, but normally you'd see Cloudflare's screen and not even be able to see this screen, so that's unlikely.

The most likely reason for it not be working is that one of the tickers you wrote is not-existing, or not properly encodeURIComponent-escaped. The best way to make sure it's the right name is to find the ticker in the Yahoo Finances url and copy it from there. Lowercase/uppercase should not matter:

https://finance.yahoo.com/quote/FIG/

// Grab that "FIG" and put it here as `?FIG=100`:

https://stocksreader.com/Portfolio?FIG=100

What stock do you recommend?

No recommendations at all, this is not a financial advice site and I'm not liable by any innaccuracy here. Please double-check the values, they might be wrong.

Who are you?

Francisco Presencia, I make a lot of open source.

How do I contact you?

Sorry, I don't really offer support for this project. This is free and amazing, so feel free to use it, but please feel free to use it.

But I want to pay you

Oh... okay, please go to my website or on Twitter. For straight up donations, hit my paypal (thanks!).

I want a new feature!

I can build it for you, please hire me. If you lead the request with a donation, I'll bump you up my queue and you'll be the first I reply to. Please only reach out if you are serious about paying:

My Website