maritime

Query bilateral oil trade flows (EIA US imports/exports + Eurostat). Accepts structured filters OR a free-text `query` (matches country/notes). NOTE: this is import/export flow data, NOT chokepoint throughput — for Hormuz transit volumes use shipping_chokepoint.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text: a country name or keyword"
    },
    "reporter": {
      "type": "string"
    },
    "partner": {
      "type": "string"
    },
    "product": {
      "type": "string"
    },
    "period": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50
    }
  }
}

Check vessel/entity against OFAC sanctions

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "type": {
      "type": "string",
      "enum": [
        "vessel",
        "company",
        "individual",
        "all"
      ]
    }
  },
  "required": [
    "query"
  ]
}

Query tanker fleet database. Accepts structured filters OR a free-text `query` (matches vessel name, IMO, owner, or type).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text: vessel name, IMO, owner company, or type"
    },
    "company": {
      "type": "string"
    },
    "vessel_type": {
      "type": "string"
    },
    "search": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50
    }
  }
}

Get oil price benchmarks (WTI, Brent)

{
  "type": "object",
  "properties": {
    "benchmark": {
      "type": "string",
      "default": "all"
    },
    "days": {
      "type": "integer",
      "default": 30
    }
  }
}

Database statistics plus per-dataset freshness: how recently each dataset was refreshed by our pipeline, how old its newest record is, and whether it is ok / lagging / stale / empty. Call this to decide how much to trust anything else this server returns.

{
  "type": "object",
  "properties": {}
}

Per-dataset freshness only: pipeline refresh age vs expected cadence, newest record age, source, and status (ok / lagging / stale / empty / unknown). Use before relying on a figure that must be current.

{
  "type": "object",
  "properties": {}
}

Top oil exporting countries by value/volume (a ranking — no query needed). Optional `product` or `query` recognizes a product keyword (crude/refined/lng/coal/iron_ore).

{
  "type": "object",
  "properties": {
    "product": {
      "type": "string",
      "default": "crude"
    },
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 20
    }
  }
}

Trade partners for a specific country (who they export to / import from). Pass the country as `country` or `query`.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string"
    },
    "query": {
      "type": "string",
      "description": "Alias for country"
    },
    "direction": {
      "type": "string",
      "default": "exports"
    },
    "limit": {
      "type": "integer",
      "default": 30
    }
  }
}

Fleet breakdown by vessel type

{
  "type": "object",
  "properties": {}
}

Query EU MRV vessel emissions data — CO2, fuel consumption, time at sea for 22,543 vessels (2018-2024). Search by IMO, ship type, or year — or a free-text `query` (7-digit = IMO, else ship type/name).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text: IMO number or ship type/name"
    },
    "imo": {
      "type": "string",
      "description": "IMO number (7 digits)"
    },
    "ship_type": {
      "type": "string",
      "description": "Ship type filter (e.g., \"Oil tanker\", \"LNG carrier\")"
    },
    "year": {
      "type": "string",
      "description": "Reporting period year (2018-2024)"
    },
    "limit": {
      "type": "integer",
      "default": 50
    }
  }
}

Find sanctioned vessels that called at EU/EEA ports. Cross-references OFAC sanctions with EU MRV emissions data (verifiable IMO-level identity). Filter by year or a free-text `query` (sanctions program e.g. "Iran"/"Russia", flag, or vessel name).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Program (e.g. \"Iran\"), flag state, or vessel name"
    },
    "year": {
      "type": "string",
      "description": "Filter by year (2018-2024)"
    },
    "limit": {
      "type": "integer",
      "default": 50
    }
  }
}

Maritime chokepoint intelligence for Hormuz, Suez, Malacca, or Bab el-Mandeb. Returns authoritative EIA baseline throughput (barrels/day, % of global), a live AIS snapshot (vessels/tankers/moving/stationary) for the chokepoint, sanctioned vessels currently detected there, and dark-fleet behavioural signals (loitering + AIS gaps). This is the tool for "how is Hormuz doing".

{
  "type": "object",
  "properties": {
    "chokepoint": {
      "type": "string",
      "description": "\"Hormuz\", \"Suez\", \"Malacca\", or \"Bab el-Mandeb\""
    },
    "query": {
      "type": "string",
      "description": "Alias for chokepoint (free text)"
    }
  }
}

Query the shipping document intelligence layer: eBL platform adoption (12 platforms), MLETR country adoption (23 countries, 13 enacted), document fraud cases ($11.3B), DCSA standards (10), industry stats (26 metrics). The state of shipping document digitization.

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "description": "Topic: \"platforms\", \"mletr\", \"fraud\", \"standards\", \"stats\", or \"overview\"",
      "enum": [
        "platforms",
        "mletr",
        "fraud",
        "standards",
        "stats",
        "overview"
      ]
    }
  },
  "required": [
    "topic"
  ]
}