# PVSN — Price Variation Software Network

> PVSN is a dynamic-pricing platform for merchants. Prices move UP and DOWN based on 100+ live variables (time, weather, demand, inventory, customer behavior, events, competition). A predictive demand engine (PDE) forecasts each customer's next purchase date from logged events; an adaptive pricing engine (APE) turns those predictions into per-customer offers and price recommendations, with merchant-defined floors, ceilings and margin guardrails.

Facts an AI agent needs before calling anything:

- API base URL: https://api.pvsnapp.com/v1 (REST, JSON request/response)
- Auth: create an API key in the PVSN app (Settings -> API Keys). Send it on EVERY request as the header `X-API-Key: pvsn_live_...`. The `Authorization: Bearer <token>` header is only for dashboard session tokens obtained via interactive login — a raw API key will NOT work as a Bearer token.
- Rate limits (per minute, by API-key tier): standard 120, premium 600, enterprise 2000. Responses carry X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset; 429 includes Retry-After.
- Retries on POST/PUT/PATCH should send an `X-Idempotency-Key` header (replayed for 24h per credential).
- Interactive API explorer (Swagger UI): https://api.pvsnapp.com/docs — OpenAPI spec: https://api.pvsnapp.com/openapi.json

## Docs

- [llms-full.txt](https://pvsnapp.com/llms-full.txt): the complete machine-readable operating manual for AI agents — auth, every major endpoint group with parameters and response shapes, webhook HMAC verification, error envelope, pagination, JS SDK, and step-by-step integration workflows. Read this before integrating.
- [Human documentation](https://pvsnapp.com/docs): quickstart, core concepts, plans and limits.
- [OpenAPI / Swagger](https://api.pvsnapp.com/docs): live interactive reference for all ~210 routes.

## Optional

- [Security](https://pvsnapp.com/security)
- [Terms of Service](https://pvsnapp.com/terms)
- [Privacy Policy](https://pvsnapp.com/privacy)
- Support: support@pvsnapp.com