# Syntalic Price History

> Syntalic Price History is a paid API for AI agents from api.syntalic.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Returns historical price observations for a product over a date range, including current price, period low/high/avg, price trend, good-deal flag, and a time-series for charting.

## Facts

- Endpoint: GET https://api.syntalic.com/v1/shopper/price-history
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402, shopping
- Canonical page: https://www.zero.xyz/c/syntalic-price-history-b21a7264
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XQR01ijwP7SCdEo4DrIUi

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability syntalic-price-history-b21a7264
```

Example prompt: Show me the price history for AirPods on Amazon in the US over the last 30 days — I want to know the current price, the period low and high, whether the price is trending up or down, and if it's a good deal right now.

## When to prefer this

Use this endpoint when you need historical price trend data for a specific product, want to determine if a product is currently at a low price, need to chart price fluctuations over a custom date range, or want to evaluate purchase timing. Prefer this over Best Price (which only gives current lowest price) when trend context, volatility, or period statistics matter. Choose this over Inflation or Price Dispersion when you want product-level history rather than category-level aggregates.

## Known failure modes

- No results found for obscure or misspelled product queries — returns empty history array
- Invalid date range (from > to) — returns 400 validation error
- Unsupported country code — returns 400 enum validation error
- Unsupported retailer value — returns 400 enum validation error
- Payment failure or insufficient USDC balance — returns 402 Payment Required
- Rate limiting if too many requests in short period — returns 429 Too Many Requests

## How this service works

Get historical price observations for a product within a date range. Returns current price, period low/high/avg, trend (rising/falling/stable), good-deal flag, and an observation time-series for charting.

## Output

Returns a JSON object with the query string and a history array of time-series price observations. Each observation includes timestamps and price data points. Top-level summary fields include current price, period low, period high, period average, trend classification (rising/falling/stable), and a boolean good-deal flag suitable for charting or purchase-timing decisions.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "q"
 ],
 "properties": {
  "q": {
   "type": "string",
   "example": "airpods",
   "minLength": 1,
   "description": "Search query (product name, keyword, or category term)"
  },
  "to": {
   "type": "string",
   "format": "date",
   "example": "2026-05-01",
   "description": "End date (ISO 8601, defaults to now)"
  },
  "from": {
   "type": "string",
   "format": "date",
   "example": "2026-04-01",
   "description": "Start date (ISO 8601, defaults to 30 days ago)"
  },
  "country": {
   "enum": [
    "us",
    "ca"
   ],
   "type": "string",
   "default": "us",
   "example": "us",
   "description": "Country (us or ca)"
  },
  "retailer": {
   "enum": [
    "amazon",
    "walmart",
    "costco",
    "homedepot",
    "nordstrom",
    "ikea"
   ],
   "type": "string",
   "example": "amazon",
   "description": "Filter to a specific retailer"
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string"
  },
  "history": {
   "type": "array",
   "items": {
    "type": "object"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/syntalic-price-history-b21a7264/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.syntalic.com](https://www.zero.xyz/host/api.syntalic.com/llms.txt)