# DecaData Company Sales

> DecaData Company Sales is a paid API for AI agents from api.decadata.io, paid per call via x402, $5/call, status unknown (last checked 2026-10-30).

Returns point-of-sale sales and unit data for a specific US consumer company by ISIN or ticker, sourced from transactions at eight US retailers.

## Facts

- Endpoint: GET https://api.decadata.io/v1/companies/:id/sales?utm_source=zero.xyz
- Price: $5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/decadata-company-sales-4c729e6f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qDuoIMjVXy7GlXT8hu-lz

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 decadata-company-sales-4c729e6f
```

Example prompt: Pull weekly point-of-sale sales and units data for PepsiCo (ticker:PEP) from DecaData for the last four weeks ending 2024-11-01.

## When to prefer this

Choose this endpoint when you need transaction-derived, retailer-sourced point-of-sale revenue and unit data for US consumer companies — not government aggregates or SEC disclosures. Ideal for investment research, brand benchmarking, or real-time consumer trend analysis where timeliness (T+7) and non-restated historical data matter. Best when you need daily granularity for large-cap consumer companies or weekly data for the broader ~380-company universe.

## Known failure modes

- Company not in coverage (~380 supported companies) returns 404 or empty result
- Invalid ISIN or ticker format returns a validation error
- Requesting daily frequency for a company only on the weekly tier returns an error or falls back
- Date range outside available history (pre-2018) returns empty or error
- Payment failure (x402) if USDC payment not provided or insufficient
- Data not yet available for dates within the T+7 lag window

## How this service works

Point-of-sale sales and units for ~380 US consumer companies, by ISIN or ticker, from transactions at eight US retailers: not government aggregates or SEC filings. Daily for the largest, weekly for all, from 2018, at T+7; each brand mapped to its owner at the time, history never restated. From $1 a request, priced per company-day. Free: sample (/v1/companies/{id}/sample), quote (/v1/quote), coverage (/v1/coverage). Docs: https://api.decadata.io/llms.txt

## Output

Returns a time series of point-of-sale sales (dollar value) and units sold for the requested company, at either daily or weekly frequency, covering the specified date range. Data is sourced from transactions at eight US retailers, with each brand mapped to its parent company at the time of sale. History is never restated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "pathParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "The company: an ISIN (US7134481081), isin:US7134481081, or ticker:PEP"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "to": {
       "type": "string",
       "description": "Last day, YYYY-MM-DD (default: the latest on sale, T+7)"
      },
      "freq": {
       "enum": [
        "daily",
        "weekly"
       ],
       "type": "string",
       "description": "daily (tiers 1-2) or weekly"
      },
      "from": {
       "type": "string",
       "description": "First day, YYYY-MM-DD (default: to, or the week of to if weekly)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/decadata-company-sales-4c729e6f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.decadata.io](https://www.zero.xyz/host/api.decadata.io/llms.txt)