# ProgramWatch

> Free public Solana program explorer and JSON API. Tracks deploy date, last activity, upgradeability, OtterSec verification, IDL availability, and update authority for 60k+ mainnet BPF programs.

ProgramWatch is **Solana-only** (base58 program addresses). Not EVM.

## When to use ProgramWatch

- Look up a Solana program by address (verified / IDL / authority / activity).
- Search programs by name fragment.
- List recently deployed or active programs.
- Fetch catalog stats or 24h invocation ranks.
- Download an IDL when available.

Do **not** use for EVM contracts, trading, or sending transactions.

## Quick links

- Site: https://programwatch.dev
- **Developers (ProgramWatch API docs):** https://programwatch.dev/developers
- Resources: https://programwatch.dev/resources
- API reference: https://programwatch.dev/api-docs
- API index (JSON): https://programwatch.dev/api
- OpenAPI: https://programwatch.dev/openapi.json
- llms.txt: https://programwatch.dev/llms.txt
- About: https://programwatch.dev/about
- Privacy: https://programwatch.dev/privacy
- Terms: https://programwatch.dev/terms
- Security: https://programwatch.dev/security
- Top programs: https://programwatch.dev/top
- Source: https://github.com/metasal1/programwatch
- X: https://x.com/programwatch
- Telegram: https://t.me/programwatch

## Versioning

`/api/*` is stable **v1**. Breaking changes will be announced on /developers#versioning with `Deprecation` and `Sunset` headers for at least 90 days.

## Errors

API errors use RFC 9457 `application/problem+json` (`code`, `detail`, `status`, optional `resolution`, plus legacy `success: false` / `error`).

## API endpoints

No auth. CORS open.

- `GET /api` — discovery index
- `GET /api/database` — paginated list (`page`, `limit`, `query`, `sortBy`, `sortOrder`, filters)
- `GET /api/program/{address}` — single program
- `GET /api/stats` — aggregates
- `GET /api/top-programs` — top 100 by 24h invocations
- `GET /api/check?address=` — live on-chain check
- `GET /api/verification?address=` — OtterSec status
- `GET /api/deploy` — deploy histogram
- `GET /api/sync-status` — sync health
- `GET /api/solgov?address=` — SolGov governance when tracked
- `GET /idl/{address}.json` — IDL when available

## Conventions

- Addresses: base58 `^[1-9A-HJ-NP-Za-km-z]{32,44}$`
- Timestamps: ISO 8601 UTC
- Boolean query params: `true` / `false`

## Contact

gm@metasal.xyz · https://t.me/metasalxyz