# BNM Data Shop – FMC Orders

> BNM Data Shop – FMC Orders is a paid API for AI agents from ticks.bnm.farm, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-20).

Returns Federal Maritime Commission (FMC) official orders and decisions extracted from the FMC Reading Room as structured JSON records.

## Facts

- Endpoint: GET https://ticks.bnm.farm/fmc-orders?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bnm-data-shop-fmc-orders-f190a652
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CeHBWumsrMELx3_ys-EPg

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 bnm-data-shop-fmc-orders-f190a652
```

Example prompt: Pull the latest Federal Maritime Commission orders and decisions from the FMC Reading Room and give me the list of dockets, institutions, and order types in a structured format.

## When to prefer this

Choose this endpoint when you need structured, machine-readable JSON access to official FMC Reading Room orders and decisions without scraping fmc.gov yourself. Ideal for compliance monitoring, regulatory intelligence, or building shipping industry data pipelines where FMC docket orders are the target data.

## Known failure modes

- HTTP 402 if payment not provided — endpoint requires $0.05 USDC via x402 protocol
- Empty records array if no FMC orders exist for the queried period
- Stale data if FMC source has not been refreshed recently (check fetchedAt vs asOf)
- Network timeout if upstream FMC PDF extraction is slow

## How this service works

Official public data as JSON. Unpaid paid routes return HTTP 402.

## Output

Returns a JSON object with ok status, product name ('fmc-order-bodies'), asOf date, fetchedAt timestamp, source URL, record count, an array of records (id, url, date, firm, type), and an array of cards (id, body, date, kind, board, title, docket, sourceUrl, documentId, institution).

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "schema": {
     "type": "object"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "required": [
   "ok",
   "product",
   "status",
   "fetchedAt",
   "asOf",
   "source",
   "recordCount",
   "records",
   "cards"
  ],
  "properties": {
   "ok": {
    "type": "boolean"
   },
   "asOf": {
    "type": "string"
   },
   "cards": {
    "type": "array",
    "items": {
     "type": "object"
    }
   },
   "source": {
    "type": "string"
   },
   "status": {
    "type": "string"
   },
   "product": {
    "type": "string"
   },
   "records": {
    "type": "array",
    "items": {
     "type": "object"
    }
   },
   "fetchedAt": {
    "type": "string"
   },
   "recordCount": {
    "type": "integer"
   }
  }
 },
 "example": {
  "ok": true,
  "asOf": "2026-01-06",
  "cards": [
   {
    "id": "23-08-131865",
    "body": "FEDERAL MARITIME COMMISSION. Docket No. 23-08. Official FMC Reading Room Initial Decision / Commission Order extracted from the www2.fmc.gov PDF.",
    "date": "2026-01-06",
    "kind": "Order on Initial Decision",
    "board": "commission",
    "title": "Served Order on Initial Decision",
    "docket": "23-08",
    "sourceUrl": "https://www2.fmc.gov/readingroom/docs/23-08/(32)%2023-08%20Order%20on%20Initial%20Decision%20(public).pdf/",
    "documentId": "131865",
    "institution": "Mediterranean Shipping Company, S.A."
   }
  ],
  "source": "https://www2.fmc.gov/ReadingRoom/",
  "status": "ok",
  "product": "fmc-order-bodies",
  "records": [
   {
    "id": "23-08-131865",
    "url": "https://www2.fmc.gov/readingroom/docs/23-08/(32)%2023-08%20Order%20on%20Initial%20Decision%20(public).pdf/",
    "date": "2026-01-06",
    "firm": "Mediterranean Shipping Company, S.A.",
    "type": "fmc-orders"
   }
  ],
  "fetchedAt": "2026-09-16T00:00:00.000Z",
  "recordCount": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bnm-data-shop-fmc-orders-f190a652/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ticks.bnm.farm](https://www.zero.xyz/host/ticks.bnm.farm/llms.txt)
