Signal reference

Every DataSig signal documented. Parameters, action vocabulary, pricing tiers, and example responses. All signals return a named action your agent can act on directly -- not a raw number to interpret.

Tariff and Sourcing Signal

Monitors Federal Register, USTR, and CBP HTS Schedule for tariff changes affecting a specific HTS code and country of origin. Returns an action signal updated continuously from live government data sources.

endpoint

GET https://datasig.ai/signals/tariff?hts_code=9403.20&origin=CN

Parameters

hts_code -- HTS code with dot notation (e.g. 9403.20 for wooden furniture, 6110.20 for cotton sweaters)
origin -- 2-letter ISO country code (CN, VN, MX, IN, BD, etc.)

Action vocabulary

ACCELERATE_ORDERS -- place orders now before rate increases or exclusions expire
DIVERSIFY_ORIGIN -- shift sourcing away from this origin country
PAUSE_ORDERS -- hold pending a tariff ruling or exclusion decision
LOCK_IN_PRICING -- lock supplier pricing before a tariff or currency move
MONITOR_ONLY -- no immediate action needed, continue monitoring

Pricing

$0.25 -- standard signal with action and confidence
$1.00 -- full signal with sourced reasoning and ruling history

example response

{
  "signal":      "ACCELERATE_ORDERS",
  "confidence":  "HIGH",
  "hts_code":    "9403.20",
  "origin":      "CN",
  "duty_rate":   "25%",
  "sources":     ["Federal Register", "USTR Section 301"],
  "summary":     "Section 301 List 3 duties confirmed at 25%...",
  "expires_at":  "2026-06-26T00:00:00Z"
}

Supplier Distress Signal

Tracks named US manufacturers via SEC EDGAR filings (going-concern warnings, revenue declines), BLS QCEW employment data by NAICS sector, and GDELT news sentiment. Returns a supplier health action for a given manufacturing sector.

endpoint

GET https://datasig.ai/signals/supplier?sector=furniture

Parameters

sector -- sector keyword: furniture, electronics, textiles, auto-parts, and others

Action vocabulary

QUALIFY_BACKUP_SUPPLIER -- start qualifying alternative suppliers now
INCREASE_SUPPLIER_AUDITS -- increase audit frequency for existing suppliers
REDUCE_SUPPLIER_CONCENTRATION -- reduce percentage of spend with any single supplier
SUPPLIER_STABLE -- no action needed, sector is stable

Pricing

$0.25 per call

example response

{
  "signal":     "QUALIFY_BACKUP_SUPPLIER",
  "confidence": "MEDIUM",
  "sector":     "furniture",
  "naics":      "337",
  "distress_indicators": {
    "sec_filings":     "2 going-concern warnings (60d)",
    "bls_employment":  "-3.2% QoQ",
    "gdelt_sentiment": "NEGATIVE"
  },
  "summary":    "Furniture sector showing employment contraction...",
  "expires_at": "2026-06-26T00:00:00Z"
}

CBP Ruling Signal

Monitors CBP CROSS database for ruling letters that reclassify goods under a given HTS prefix and origin. A reclassification can change landed cost by 5 to 25 percent and affects all open purchase orders for that HTS code.

endpoint

GET https://datasig.ai/signals/cbp-ruling?hts_prefix=940320&origin=CN

Parameters

hts_prefix -- HTS prefix without dots (e.g. 940320, not 9403.20)
origin -- 2-letter ISO country code

Action vocabulary

RECALCULATE_LANDED_COST -- new ruling changes duty rate, recalculate landed cost on all open orders
FLAG_OPEN_POS -- flag open purchase orders for review before shipment clears customs
ORIGIN_RULING_STABLE -- no recent rulings affecting this HTS prefix and origin

Pricing

$1.00 per call

example response

{
  "signal":     "RECALCULATE_LANDED_COST",
  "confidence": "HIGH",
  "hts_prefix": "940320",
  "origin":     "CN",
  "ruling_id":  "H123456",
  "ruling_date":"2026-06-10",
  "summary":    "New CBP ruling reclassifies wooden office chairs...",
  "expires_at": "2026-06-26T00:00:00Z"
}

Berth Congestion Delta

Monitors AIS vessel data for 6 US ports and 5 major Asian ports every 2 hours. Returns the 24-hour vessel count delta, disruption type, projected recovery time, and alternative port context. Three pricing tiers based on data freshness and intelligence depth.

endpoint

GET https://datasig.ai/signals/berth-congestion?port=USLAX

Parameters

port -- port code from the supported list below

Supported ports

US: USLAX (Los Angeles), USLGB (Long Beach), USOAK (Oakland), USSEA (Seattle), USSAV (Savannah), USNYK (New York)
Asia: CNSHA (Shanghai), CNYTN (Yantian), CNNGB (Ningbo), CNQIN (Qingdao), KRPUS (Busan)

Action vocabulary

BOOK_CAPACITY_NOW -- congestion worsening, book capacity before it tightens further
MONITOR_CONGESTION -- congestion elevated but stable, continue monitoring
PORT_CLEAR -- congestion clearing, normal operations expected

Pricing tiers

$0.01 -- stale data (4-24h old), staleness warning included in response
$0.10 -- verified data plus 24-hour delta
$1.00 -- verified data plus delta, disruption type, projected recovery time, and alternative ports context

example response -- $1.00 tier

{
  "port":                    "USLAX",
  "signal":                  "BOOK_CAPACITY_NOW",
  "vessels_at_anchor":       18,
  "delta_24h":               6,
  "pct_change":              "+50%",
  "disruption_type":         "volume_spike",
  "projected_recovery_time": "72-96 hours",
  "alternative_ports_context": {
    "USLGB": "viable",
    "USOAK": "best_alternative",
    "USSEA": "viable"
  },
  "data_age_hours":          1.8,
  "expires_at":              "2026-06-25T14:00:00Z"
}

Blank Sailing Predictor

Status: returns INSUFFICIENT_DATA. No verified carrier schedule source exists yet, so the probability model does not run and every lane gates to INSUFFICIENT_DATA with agent_action: CHECK_CARRIER_DIRECTLY. That response is served free ($0.00) and is never settled. Read the x-datasig-data-quality header on the 402 (available or insufficient) before paying. Everything below describes the model as it will behave once a schedule source is live.

Predicts blank sailing probability for a carrier and trade lane using a 5-factor model: origin congestion (30%), destination congestion (25%), historical blank rate (20%), rate change (15%), and schedule deviation (10%). Incorporates seasonal events including Chinese New Year, Golden Week, and US peak season. Updated every 6 hours across 8 trade lanes. At probability above 0.75, the $5.00 tier fires with a projected cancellation date and cost of inaction.

endpoint

GET https://datasig.ai/signals/blank-sailing?carrier=MSC&origin=CNSHA&destination=USLAX

Parameters

carrier -- carrier code: MSC, MAERSK, CMACGM, and others
origin -- origin port code: CNSHA, CNYTN, CNNGB, CNQIN, KRPUS
destination -- destination port code: USLAX, USLGB, USOAK, USSEA, USSAV, USNYK

Action vocabulary

BOOK_EARLY_SAILINGS -- high blank sailing probability, book now before capacity disappears
PRE_POSITION_INVENTORY -- position inventory ahead of likely disruption
MONITOR_SCHEDULE -- probability elevated, monitor carrier schedule for changes
PROCEED_NORMAL -- low blank sailing risk on this lane

Pricing tiers

$0.10 -- probability score only
$1.00 -- probability plus factor breakdown and alternative carrier options
$5.00 -- full intelligence: projected cancellation date, cost of inaction, alternative options with availability scores. Fires automatically when probability exceeds 0.75.

example response -- $5.00 tier (once a carrier schedule source is live)

{
  "signal":      "BOOK_EARLY_SAILINGS",
  "probability": 0.82,
  "carrier":     "MSC",
  "trade_lane":  "CNSHA-USLAX",
  "projected_cancellation_date": "2026-07-08",
  "cost_of_inaction": "Est. $4,200 premium if booking post-cancellation",
  "alternative_options": [
    { "carrier": "MAERSK", "availability": 0.85, "next_sailing": "2026-07-05" },
    { "carrier": "CMACGM", "availability": 0.71, "next_sailing": "2026-07-07" }
  ],
  "factors": {
    "origin_congestion":    0.78,
    "dest_congestion":      0.45,
    "historical_blank_rate": 0.65,
    "rate_change":          0.90,
    "schedule_deviation":   0.70
  },
  "expires_at": "2026-06-25T18:00:00Z"
}

Common response fields

Every paid signal response includes these fields in addition to signal-specific data:

common fields

{
  // Signal-specific fields above, plus:
  "_datasig": {
    "source":     "DataSig",
    "version":    "1.0",
    "signal":     "tariff",
    "signal_hash":"a3f8b2c1...",  // provenance fingerprint
    "live_data":  true,
    "verify_at":  "https://datasig.ai/signals/docs/"
  },
  "_datasig_pricing": {
    "tier":               "EARLY_ADOPTER",
    "calls_total":        6,
    "discount_pct":       30,
    "calls_to_next_tier": 4,
    "next_tier_benefit":  "15% permanent",
    "permanent":          false
  }
}

The _datasig block includes a provenance fingerprint -- a SHA-256 hash of the response payload. The _datasig_pricing block shows your wallet's current discount tier and progress toward the next one.

ILA Labor Sentiment Signal

Monitors NLRB filings, news sentiment, contract status, and strike authorization votes to produce a labor disruption probability score for ILA-covered US East and Gulf Coast ports. At probability above 0.65, the $5.00 tier fires with a projected disruption window, inventory buffer recommendation, cost of inaction per container, and alternative routing options.

endpoint

GET https://datasig.ai/signals/ila-labor?port=USNYK

Parameters

port -- ILA-covered port code: USNYK, USBLT, USSAV, USORF

Supported ports

USNYK -- New York / New Jersey
USBLT -- Baltimore
USSAV -- Savannah
USORF -- Norfolk / Virginia

Action vocabulary

PRE_POSITION_INVENTORY -- move inventory now before disruption window
BOOK_EARLY_SAILINGS -- reroute bookings to West Coast or Gulf alternatives
MONITOR_LABOR -- probability elevated (0.30-0.65), watch contract negotiations
LABOR_STABLE -- no disruption risk, proceed normally

Pricing tiers

$2.00 -- disruption probability score + action signal + factor breakdown
$5.00 -- full intelligence: projected disruption window, inventory buffer days, cost of inaction per container, alternative routing options. Fires automatically when probability exceeds 0.65.

example response -- $5.00 tier

{
  "signal":      "PRE_POSITION_INVENTORY",
  "probability": 0.72,
  "confidence":  "MEDIUM",
  "port":        "USNYK",
  "affected_ports": ["USNYK", "USBLT", "USSAV", "USORF"],
  "factors": {
    "nlrb_filings_30d":  0.80,
    "news_sentiment":    0.65,
    "contract_status":   0.70,
    "strike_auth_vote":  0.00
  },
  "projected_disruption_window": "2026-09-15 to 2026-10-01",
  "inventory_buffer_days":       21,
  "cost_of_inaction":    "Est. $8,400 per container rerouted post-strike",
  "alternative_routing": {
    "USLAX": "viable -- add 4-5 days transit",
    "USHOU": "viable -- Gulf Coast alternative"
  },
  "data_sources": ["NLRB API", "NewsAPI"],
  "expires_at":   "2026-06-26T04:00:00Z"
}

Carrier Reliability Signal

Predicts a carrier's on-time performance for a specific trade lane over the next 30 days using a 5-factor scoring model: Sea-Intelligence baseline (30%), AISstream schedule deviation (25%), destination berth congestion (20%), blank sailing probability (15%), and Freightos FBX rate volatility (10%). At score below 50 or blank sailing probability above 0.75, the REBOOK_NOW signal fires with alternative carrier options and cost of inaction.

endpoint

GET https://datasig.ai/signals/carrier-reliability?carrier=MSC&origin=CNSHA&destination=USSAV

Parameters

carrier -- carrier code: MSC, MAERSK, CMACGM, HAPAG, EVERGREEN, COSCO, ONE, ZIM, YANGMING
origin -- origin port: CNSHA, CNYTN, CNNGB, CNQIN, KRPUS
destination -- destination port: USLAX, USLGB, USOAK, USSEA, USSAV, USNYK

Action vocabulary

BOOK_WITH_CONFIDENCE -- score >= 75, trend stable or improving
MONITOR_SCHEDULE -- score 60-74, or trending down
CONSIDER_ALTERNATIVES -- score 50-59
REBOOK_NOW -- score < 50, or blank sailing probability > 0.75

Pricing tiers

$0.50 -- reliability score + signal only
$2.00 -- full 30-day projection with factor breakdown, alternative carriers, and cost of inaction. Early adopter: $1.40 through 2026-09-21.

example response -- $2.00 tier

{
  "signal":             "BOOK_WITH_CONFIDENCE",
  "carrier":            "MSC",
  "trade_lane":         "CNSHA→USSAV",
  "reliability_score":  78,
  "reliability_level":  "MEDIUM",
  "trend":              "improving",
  "urgency":            "LOW",
  "alternative_carriers": [
    { "carrier": "GEMINI", "reliability_score": 87 },
    { "carrier": "HAPAG",  "reliability_score": 79 }
  ],
  "cost_of_inaction":   "If reliability drops below 65: est. $500-2,000/container rebooking fees",
  "confidence":         0.78,
  "n_factors_available":4,
  "expires_at":         "2026-06-27T06:00:00Z"
}

What next

New to DataSig? Start with the quick start guide to make your first call. Or go straight to the free trial endpoint to see live signal data without any payment.