Access transparent freight market data with the free NYFI API.
Integrate NYFI data directly into your internal systems for custom analysis and automated reporting. Accessing the public NYFI API is free. All you have to do is to sign-up and request your API keys via our platform. In no time you will be powering your organization with neutral, auditable data built for global trade.
Get Access
NYFI API Documentation
Introduction
The NYSHEX Freight Indices (NYFI) API provides authenticated NYSHEX users with secure and reliable access to all the free NYFI index data, enabling seamless integration into internal systems, reports, and dashboards.
While all NYFI platform users can sign up and access index data via the public API, NYSHEX PRO users may Contact Us or their direct NYSHEX representative for extended access to additional datasets.
Authentication
Get Free API Access
Create a free NYSHEX account to generate your unique API key and start exploring live NYFI data. After signing in, go to Help Center → NYFI API Documentation, to view or generate your API key.
Get AccessAPI Request
Base URL: GET
/dataapi.nyshex.com/index/v1/list Authentication
To authenticate your requests, include your API key in the request header using the Authorization: ApiKey <key> header field.
Sample Request Header
When making API requests, you must include your API key using the Authorization: ApiKey <key>
HTTP header. This authenticates your request and grants access based on your account permissions.
Header Format: Authorization: ApiKey <key>
Example with Sample Key: Authorization: ApiKey nyx_1234abc_5678
Replace <key> or ApiKey nyx_1234abc_5678 with your actual API key obtained from your NYSHEX account settings. The API key should be included in every request to authenticate your identity and authorize access to the NYFI data.
Request Params
- startDate
- Required: No. If not provided, the API defaults to returning index data from the last 2 years from the current date. You can override this by specifying a startDate to retrieve data from a specific point in time. Use in combination with endDate to define a custom date range.
- Type: String
- Format: ISO 8601: YYYY-MM-DDTHH:mm:ss.sssZ
- Sample Value: 2024-05-29T06:37:34.262Z
- endDate
- Required: No. If not provided, the API defaults to the current date. Use in combination with startDate to define a custom date range.
- Type: String
- Format: ISO 8601: YYYY-MM-DDTHH:mm:ss.sssZ
- Sample Value: 2024-05-29T06:37:34.262Z
- indexNames
- Required: No. If not provided, the API returns all available indices.
- Type: List of Strings
- Sample Value: TRANS-PACIFIC EASTBOUND
Sample API Request
API Response
Format: JSON
Sample API Response
{
"timeframes": [
{
"timeframe": "2024-21",
"publishDate": "2024-05-31",
"indices": [
{
"index": "TRANS-PACIFIC EASTBOUND",
"abbreviation": "TPEB",
"values": [
{
"type": "40GP/HC",
"value": 3930.42,
"message": null
}
],
"subIndices": [
{
"index": "Far East to USWC",
"abbreviation": "FEUSWC",
"values": [
{
"value": 3677.52,
"message": null
}
]
}
]
}
]
}
]
}
Response Objects
Top Level Field: timeframes (Array)
Each object represents a specific weekly period for which indices data is published.
| Field | Type | Nullable | Description |
|---|---|---|---|
| timeframe |
string |
N |
The week identifier in the format YYYY-WW (e.g., "2024-21" = week 21 of 2024). |
| publishDate |
string |
N |
The date when data is published, formatted as DD-MMM-YYYY. |
| indices |
array |
N |
Contains index objects for various trade lanes and sub-indices. |
Bring market intelligence into your workflow.
With NYFI, you can integrate verified rate data, monitor volatility, and benchmark performance—all in real time through the NYSHEX API.
Get API Access