PVSN

PVSN Documentation

Everything you need to price dynamically — from first principles to the API.

What is PVSN

PVSN (Price Variation Software Network) is a dynamic pricing platform. It continuously moves prices up and down based on 100+ real-world signals so every product is sold at the right price at the right moment.

Prices go UP when demand, scarcity, or willingness-to-pay is high.
Prices go DOWN to win price-sensitive shoppers and clear slow inventory.
A floor, ceiling, and margin guardrail keep every price inside limits you set.
Works for one product or a catalog of millions, per customer or store-wide.

Quickstart

Get from zero to your first dynamic price in five steps.

  1. 1
    Request access

    PVSN is in private beta — join the waitlist and we'll invite you in as spots open. Every new account starts on the free plan: the on-device neural-network pricing engine and a 14-day full-feature trial, no card required.

  2. 2
    Add products

    Import a CSV or create products in the dashboard. Each product needs a name, a base price, and (optionally) a unit cost so margin guardrails work.

  3. 3
    Log events

    Send views, purchases, and cart events via the API or an integration. The engine learns demand and lifecycle from this stream.

  4. 4
    Set guardrails

    Define a price floor, ceiling, and minimum margin. PVSN will never price outside these bounds.

  5. 5
    Read prices

    Call the pricing endpoint (or drop in the JavaScript SDK) and serve the returned price to your storefront.

curl -X POST https://api.pvsnapp.com/v1/events \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id": 1, "event_type": "purchase", "customer_id": 42}'

Core concepts

PDE — Prediction & Demand Engine

The PDE turns your event history into demand, lifecycle, seasonality, and per-customer need predictions using weighted recency, outlier filtering, and confidence scoring.

APE — Adaptive Pricing Engine

The APE turns those predictions into a price. It blends elasticity learning, inventory scarcity, urgency, and your merchant rules into a single confidence-aware number.

Pricing variables

100+ signals feed the price — time of day, weather, demand, inventory, customer segment, events, competition, and product lifecycle among them. Each nudges the price up or down.

Guardrails

Floor, ceiling, margin protection, and velocity limits bound every price. Guardrails always win over the model, so prices stay safe and on-brand.

Connecting your store

Bring your catalog and events into PVSN with whichever path fits your stack.

Shopify

Install the webhook receiver to sync products, orders, and customers automatically.

WooCommerce

Use the WooCommerce adapter to sync products, orders, and customers on a schedule.

Direct API

Push products and events straight to the REST API — ideal for custom storefronts.

CSV import

Upload products, customers, and events from a spreadsheet with validation and downloadable templates.

Using the API

The PVSN REST API is the same engine the dashboard uses. Base URL and auth below.

Authentication

Send your API key in the X-API-Key header on every request — not as a Bearer token. A raw API key placed in Authorization: Bearer is rejected with 401; the Bearer header is only for short-lived dashboard session tokens. Keys are created and rotated from the API Keys page.

X-API-Key: YOUR_API_KEY
Base URL: https://api.pvsnapp.com/v1

Key endpoints

GET/products
List and manage your product catalog.
POST/events
Log a view, purchase, or cart event.
GET/price-variation/calculate/{id}
Get the current dynamic price for a product.
GET/offers
List, generate, and accept personalized offers.
GET/predictions
Read demand and per-customer need predictions.
POST/pricing-rules
Set price floors, ceilings, and discount/markup caps.
POST/webhooks
Subscribe to offer, prediction, and reward events.
POST/assistant/chat
Ask the built-in AI assistant about your store (paid plans).

Full machine-readable reference for every endpoint: /llms-full.txt

Rate limits

Limits are enforced per API key tier. Exceeding them returns HTTP 429 with a Retry-After header.

  • Standard — 120 requests / minute
  • Premium — 600 requests / minute
  • Enterprise — 2,000 requests / minute

Plans & limits

Free runs entirely on the local neural-network engine. Paid tiers add variables, integrations, and the AI advisor. Developers can pay per API call.

FAQ & help

Still stuck? These resources go deeper.

Contact supportLive demo storeTerms of ServicePrivacy Policy

For AI agents

Integrating with Claude, GPT, or your own agent? Hand it one of these plain-text files. They are written for machines, not people — full API reference, auth, webhook signature verification, and step-by-step workflows.

/llms.txt

Short index file following the llms.txt standard: what PVSN is, the API base URL, how auth works, and where the full manual lives.

Open Download

/llms-full.txt

The complete machine-readable operating manual. Paste it into your agent's context or point the agent at the URL — it covers every major endpoint with parameters and response shapes.

Open Download

MCP server

Connect Claude Desktop, Claude Code, or any MCP-compatible agent directly to your PVSN account. The @pvsn/mcp-server package exposes products, customers, predictions, offers, price recommendations, and analytics as typed tools — no integration code needed. Grab an API key from Settings → API Keys, then add this to your Claude Desktop config (claude_desktop_config.json):

# @pvsn/mcp-server is not on npm yet (npm publish coming soon).
# Until then, install from source:
git clone https://github.com/Reddog30/PVSN.git
cd PVSN/sdk/mcp-server
npm install && npm run build   # builds dist/index.js
{
  "mcpServers": {
    "pvsn": {
      "command": "node",
      "args": ["/absolute/path/to/PVSN/sdk/mcp-server/dist/index.js"],
      "env": {
        "PVSN_API_KEY": "YOUR_PVSN_API_KEY"
      }
    }
  }
}

Or add it to Claude Code with one command:

claude mcp add pvsn -e PVSN_API_KEY=YOUR_PVSN_API_KEY -- node /absolute/path/to/PVSN/sdk/mcp-server/dist/index.js