API Reference

JSON over HTTP. CORS open to all origins. No auth. No rate limits beyond Cloudflare's edge defaults.

Free to use. The API is free for any purpose — personal, research, commercial. No registration, no quotas. If it's helpful, a tweet crediting @metasal or @programwatch is appreciated 🙏

Live program alerts: join t.me/programwatch.

Scope: Solana mainnet programs only. No EVM / other chains.

Base URL: https://programwatch.dev

Format: JSON, all timestamps ISO 8601 UTC

Address format: base58, 32–44 chars (^[1-9A-HJ-NP-Za-km-z]{32,44}$)

Boolean filters: string true or false

For LLMs / agents: /llms.txt contains a structured intro to this API.

Interact with programs: the “API & MCP” links on program pages are powered by Orquestra, which turns any program's IDL into a hosted REST API and MCP server.

GET/api/program/{address}

Single program record by address (includes light usage: top_rank / 24h invocations when ranked, last_activity_at, sampled tx_*).

Param		Description
address	required	Base58 Solana program address (32–44 chars).

/api/program/JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4

GET/api/solgov

SolGov governance lookup for a program address (static program→protocol index + live threshold/timelock/alerts). Unmatched programs return matched:false.

Param		Description
address	required	Base58 Solana program address.

/api/solgov?address=JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4

GET/api/database

Paginated, sortable, filterable list of programs.

Param		Description
page		Page number (default 1).
limit		Page size (default 10).
query		Search by program name or address (partial match).
sortBy		name \| size \| slot \| deployed \| last_activity_at
sortOrder		asc \| desc
executable		true \| false
mutable		true \| false (upgradeable)
verified		true \| false
idl		true \| false (has IDL)
deployedSince		ISO 8601 cutoff — returns programs deployed at or after.
activeSince		ISO 8601 cutoff — returns programs active at or after.

/api/database?sortBy=last_activity_at&sortOrder=desc&limit=10

GET/api/check

Live on-chain check for a single program — fetches PDA, authority, slot, deploy time.

Param		Description
address	required	Base58 Solana program address.

/api/check?address=JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4

GET/api/verification

Verification status for a program (source ↔ on-chain bytecode match) via verify.osec.io.

Param		Description
address	required	Base58 Solana program address.

/api/verification?address=JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4

GET/api/stats

Aggregate counts: total / executable / verified / mutable / frozen / has IDL.

/api/stats

GET/api/top-programs

Top 100 programs by instruction invocations over the last 24h (incl. CPIs, excl. Vote/ComputeBudget). Refreshed daily from Dune.

/api/top-programs

GET/api/deploy

Monthly deployment histogram across the dataset.

/api/deploy

GET/api/sync-status

Last sync timestamps and counts.

/api/sync-status

GET/idl/{address}.json

IDL file for a program when available (Anchor or Codama format).

/idl/De1egAFMkMWZSN5rYXRj9CAdheBamobVNubTsi9avR44.json

Issues or suggestions? t.me/metasalxyz · [email protected] · Source on GitHub.