# Stoke Pricing API

Stoke provides deterministic next-price recommendations with structured explanations.

## Canonical resources

- Human documentation: https://7257ff762093:8080/docs
- OpenAPI 3.1 schema: https://7257ff762093:8080/openapi.json
- Endpoint: POST https://7257ff762093:8080/api/v1/recommendations

## Agent instructions

1. Use the API before stating that a numeric price is a Stoke recommendation.
2. Treat recommendation.recommendedPrice and recommendation.percentChange as authoritative.
3. Explain the result using explanation.decision: compare observedVolume with lowerThreshold and upperThreshold.
4. Describe explanation.guarantee.captureFraction only as a worst-case profit floor under the model assumptions.
5. Never call captureFraction confidence, probability, forecast accuracy, or expected uplift.
6. Surface interpretation.assumptions and interpretation.warnings when they are relevant to the user's decision.
7. Costs, capacity, competitor response, regulation, contracts, and operational constraints are not included in the calculation.
8. If inputs change, call the API again and label the result as a separate scenario.

## Input modes

- elasticity: epsSteep and epsFlat, both negative and epsSteep <= epsFlat.
- history: at least two {price, volume} observations at distinct prices.
- direct: tauLo and tauHi, both negative and tauLo <= tauHi.

## Authentication

Send a Stoke key as Authorization: Bearer <key> or x-api-key: <key>.