Get freight market intelligence and economic indicators

curl -X POST https://freightrateintelligence.com/v1/market/analysis \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "ok": true,
  "data": {
    "request_context": {
      "scope": "string",
      "region": "string",
      "mode": "string",
      "period": "string",
      "focus_areas": [
        "string"
      ]
    },
    "summary": {
      "headline": "string",
      "narrative": "string",
      "key_drivers": [
        {
          "driver": "string",
          "direction": "BULLISH",
          "impact": "HIGH",
          "evidence": "string"
        }
      ]
    },
    "indicators": [
      {
        "name": "string",
        "series_id": "string",
        "value": 1.1,
        "unit": "string",
        "trend": "RISING",
        "source": "string",
        "observation_date": "2023-01-15",
        "source_auth_obj_id": "string",
        "age_days": 1,
        "stale": true,
        "staleness_note": "string"
      }
    ],
    "capacity_snapshot": {
      "capacity_pressure_index": 1.1,
      "capacity_label": "string",
      "carrier_authority_net_change_30d": 1,
      "assessment": "string",
      "note": "string"
    },
    "outlook": {
      "direction": "BULLISH",
      "horizon": "string",
      "rationale": "string",
      "risks": [
        "string"
      ]
    },
    "confidence": {
      "level": "HIGH",
      "score": 1.1,
      "label": "string",
      "factors": [
        "string"
      ]
    },
    "model_type": "MARKET_ANALYSIS",
    "model_disclaimer": "string",
    "factor_versions": [
      {
        "source": "EIA",
        "series_id": "PET.EMD_EPD2DXL0_PTE_R30_DPG.W",
        "version": "latest",
        "fetched_at": "2024-01-15T09:30:00Z"
      }
    ]
  },
  "receipt_id": "rcpt_01abc...",
  "auth_obj_id": "auth_01xyz..."
}

Analyzes macro freight market conditions using FRED, EIA, and BLS economic indicators. Returns a headline summary, key drivers with directional signals, capacity snapshots, and a forward-looking outlook. Requires Starter tier.

Authentication

AuthorizationBearer

Your Freight Rate Intelligence API key. Get one at freightrateintelligence.com/dashboard/settings

Request

This endpoint expects an object.

scopeenumOptionalDefaults to NATIONAL

NATIONAL for full market view, REGIONAL for specific region analysis.

Allowed values:

regionstring or nullOptional

Region filter. Use with scope REGIONAL. Examples: ‘Gulf Coast’, ‘Midwest’, ‘West Coast’.

modeenumOptional

Mode parameter accepted for context but does not change the market analysis output. Market analysis is macro-level across all modes.

Allowed values:

focus_areaslist of stringsOptional

Specific areas to focus analysis on. Valid values: ‘fuel’, ‘labor’, ‘capacity’, ‘demand’, ‘regulatory’.

periodenumOptionalDefaults to 30d

Analysis lookback period.

Allowed values:

include_indicatorsbooleanOptionalDefaults to true

Include detailed indicator data in response.

Response

Market analysis with receipt

okboolean

dataobject

Skill-specific response data

receipt_idstring

auth_obj_idstring

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error