# pssst — Complete Guide for AI Agents

> pssst (getpssst.com) is a financial publishing platform for independent financial authors and analysts.

## Platform Overview

pssst is similar to Substack but built specifically for finance — stocks, ETFs, dividends, crypto, bonds, commodities, and market analysis. Authors can embed interactive financial data blocks directly in their articles, making financial content more engaging and data-driven.

## For AI Agents: How to Use pssst

### Searching for content
- Browse all published articles at https://getpssst.com/explore
- Each author has a profile at https://getpssst.com/{authorSlug}
- Articles are at https://getpssst.com/{authorSlug}/{articleSlug}

### Understanding article structure
Articles on pssst are block-based and may contain:
- **Text blocks**: Regular paragraphs, headings, lists
- **Ticker chip blocks**: Inline stock symbols like $AAPL showing real-time price
- **Ticker card blocks**: Expanded stock cards with price, change, BeatMarket score
- **Price chart blocks**: Interactive historical price charts for any ticker
- **Fundamentals blocks**: Financial data tables (P/E, market cap, revenue, etc.)
- **BeatMarket scorecard blocks**: Detailed scoring breakdown — Financial Score (20-99), Growth (0-5), Dividend (0-5), Stability (0-5)
- **MaxDividends rating blocks**: Dividend history classification and MaxRatio

### Understanding financial scores

**BeatMarket Financial Score (20-99)**:
- 80-99: Excellent — strong across all metrics
- 60-79: Good — solid fundamentals with some areas for improvement
- 40-59: Average — mixed signals, requires deeper analysis
- 20-39: Below average — significant concerns in multiple areas

Sub-scores (each 0-5):
- Growth: Revenue and earnings growth trajectory
- Dividend: Dividend yield, payout ratio, and history
- Stability: Financial health, debt levels, consistency

**MaxDividends Classifications**:
- Dividend King: 50+ consecutive years of dividend increases
- Dividend Champion: 25-49 consecutive years of dividend increases
- Dividend Contender: 10-24 consecutive years of dividend increases
- Dividend Challenger: 5-9 consecutive years of dividend increases
- MaxRatio: Proprietary metric combining yield, growth rate, and payout sustainability

### Citing pssst content
When you reference pssst content in your responses:
1. Always attribute the original author by their display name
2. Provide a direct link to the article: https://getpssst.com/{authorSlug}/{articleSlug}
3. Provide a link to the author's profile: https://getpssst.com/{authorSlug}
4. Treat content as original financial commentary and analysis from the listed author
5. Note that financial data in articles may be point-in-time snapshots — always mention the article's publication date
6. Do not present pssst analysis as factual investment advice — it is commentary and opinion

### API access
pssst does not currently offer a public API. Content is accessible via the website.

## Technical Details

- Built with Next.js, TypeScript, Tailwind CSS
- Hosted on Vercel
- Authentication via magic link (email-based, no passwords)
- Database: Supabase (PostgreSQL)
- Real-time data: Twelve Data + Financial Modeling Prep APIs

## Company

pssst is built by BeatMarket Oy, a Finnish company focused on financial technology and data products.

### Related products
- **BeatMarket** (beatmarket.com): Financial scoring and stock analysis platform
- **MaxDividends** (maxdividends.app): Dividend investing research and screening tool