# DataSig CBP Ruling Signal

> DataSig CBP Ruling Signal is a paid API for AI agents from datasig.ai, paid per call via x402, $0.7/call, status unknown (last checked 2026-09-13).

Returns an actionable supply chain signal for a given HTS code and origin country based on live U.S. Customs and Border Protection (CBP) ruling activity

## Facts

- Endpoint: GET https://datasig.ai/signals/cbp-ruling
- Price: $0.7/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/datasig-cbp-ruling-signal-8274241f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_s5eAiRxglEu1bZ8SgsuXU

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 datasig-cbp-ruling-signal-8274241f
```

Example prompt: Check DataSig for any CBP ruling signals affecting HTS code 940320 imported from China — do I need to recalculate my landed cost?

## When to prefer this

Use this endpoint when an AI agent needs to make real-time trade compliance decisions based on U.S. Customs and Border Protection ruling activity for a specific product (by HTS code) and country of origin. It is particularly valuable for procurement automation, landed cost calculations, and import risk workflows where up-to-date CBP intelligence is critical and API-key-free x402 micropayment access is preferred.

## Known failure modes

- Missing or invalid HTS prefix returns an error or empty signal
- Invalid ISO country code causes a 400-level response
- No CBP ruling activity found may return null signal or low-confidence result
- Payment failure via x402 micropayment blocks access to the response
- HTS prefix too broad or too narrow may yield ambiguous signals

## How this service works

DataSig delivers live supply chain action intelligence to AI agents via x402 micropayments. Tariff changes, port congestion, blank sailing risk, supplier distress. Pay per call in USDC on Base. No API key.

## Output

A JSON object containing a supply chain action signal (e.g. 'RECALCULATE_LANDED_COST'), the HTS prefix queried, and an optional confidence score. The signal tells an AI agent what action, if any, is warranted based on live CBP ruling activity for that commodity and origin country.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "hts_prefix",
      "origin"
     ],
     "properties": {
      "origin": {
       "type": "string",
       "description": "2-letter ISO country code"
      },
      "hts_prefix": {
       "type": "string",
       "description": "HTS prefix without dots e.g. 940320"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "signal": "RECALCULATE_LANDED_COST",
  "confidence": null,
  "hts_prefix": "940320"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/datasig-cbp-ruling-signal-8274241f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from datasig.ai](https://www.zero.xyz/host/datasig.ai/llms.txt)