# SatStash

> SatStash is a Bitcoin marketplace with read-only public REST APIs for active listings and auctions.

## Canonical discovery
- Agents page: https://satstash.io/agents
- OpenAPI schema: https://satstash.io/api/public/v1/openapi.json
- Interactive API docs: https://satstash.io/api/public/v1/docs
- llms-full profile: https://satstash.io/llms-full.txt

## Public API summary
- Base URL: https://satstash.io/api/public/v1
- Authentication: none (anonymous read-only v1)
- CORS: *
- Pagination: cursor-based
- Errors: RFC 7807 (application/problem+json)

## High-value endpoints
- GET /api/public/v1/drops
- GET /api/public/v1/drops/{id}
- GET /api/public/v1/stores/{slug}

## Crawl policy
- Keep request rates moderate.
- Prefer OpenAPI schema for contract details.
- Use active inventory only; sold/ended history is out of scope in v1.