Ocean LCL Rate Query
Query real-time LCL rates by POL + POD + consol warehouse. Billed by W/M (the greater of weight tons or volume tons), with destination port fees and POL surcharges included.
Endpoint Info
| Endpoint | POST /api/openapi/v1/freight/lcl/search |
| Credit cost | 1 credits / call |
| Data freshness | Daily |
Request Parameters
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
| pol | string | Yes | Port of Loading, accepts 5-letter code (exact) / Chinese / English (fuzzy)Look up code ↗ | CNSHA / Shanghai |
| pod | string | Yes | Port of Discharge, accepts 5-letter code (exact) / Chinese / English (fuzzy)Look up code ↗ | DEHAM / Hamburg |
| warehouse | string | No | Consol warehouse (YTL/JGC/YTLM, etc.) | YTL |
| carrier | string | No | Filter by consolidator code | ECU |
| page | int | No | Page number, default 1 | 1 |
| limit | int | No | Page size, default 20, max 50 | 20 |
| pol_country | string | No | Origin country code (2-letter ISO, optional); pins the country when pol matches multiple same-name ports | CN |
| pod_country | string | No | Destination country code (2-letter ISO, optional). When pod matches multiple same-name ports, without it rates for all same-name ports are returned and charged per matched port; pass it to pin a single country | US |
Response Fields
| Field | Type | Description |
|---|---|---|
| resolved.pol / pod | object | Echo of the parsed port (with input/code/name/name_en) |
| list[].id | string | Unique rate record ID |
| list[].pol / pod | object | POL / POD { code, name, name_en } |
| list[].carrier | object | Carrier { code, name } (e.g. MAT Matson, EMC Evergreen) |
| list[].warehouse | object | Consol warehouse { code, name } (e.g. JGC Bonded Warehouse, YTL Yingtong Warehouse) |
| list[].transit | object | { is_direct: direct routing, days: transit days, port/port_en: transshipment port in Chinese/English } |
| list[].schedule.cutoff_date | string | Cut-off date YYYY-MM-DD |
| list[].schedule.departure_date | string | Departure date (ETD) YYYY-MM-DD |
| list[].schedule.arrival_date | string | Estimated arrival date (ETA) |
| list[].price.value | number | W/M unit price |
| list[].price.unit | string | Billing unit (e.g. CNY/W/M meaning CNY billed per W/M) |
| list[].price.weight_ratio | string | Weight-to-volume ratio (e.g. 1:750 meaning 1 CBM equals 750 kg) |
| list[].local_fee | object | null | Local fees { type, price, remark } (e.g. AMS/DOC; null when none) |
| list[].remark | string | Remarks (e.g. max volume limit <=5RT) |
| list[].updated_at | string | Last update date YYYY-MM-DD |
| credit_used / credit_balance | int | Credits deducted (LCL fixed at 1) / remaining |
Full curl Example
# pol / pod accept either 5-letter standard code, Chinese, or English (e.g. "CNSHA" / "上海" / "shanghai")
curl -X POST https://www.5688.cn/api/openapi/v1/freight/lcl/search \
-H "Content-Type: application/json" \
-H "X-Awice-AppKey: AK_xxxxxxxxxxxxxxxx" \
-H "X-Awice-Timestamp: 1746086400" \
-H "X-Awice-Nonce: a1b2c3d4e5f6a7b8" \
-H "X-Awice-Signature: 7f8e9d6c5b4a..." \
-d '{
"pol": "CNSHA",
"pod": "USLSA",
"warehouse": "YTL",
"page": 1,
"limit": 20
}'Successful Response
{
"code": 0,
"msg": "success",
"request_id": "req_xxxxxxxxxxxxxxxx",
"data": {
"resolved": {
"pol": { "input": "CNSHA", "code": "CNSHA", "name": "Shanghai", "name_en": "shanghai" },
"pod": { "input": "USLSA", "code": "USLSA", "name": "Los Angeles", "name_en": "los angeles,ca" },
"carrier": null
},
"total": 2,
"page": 1,
"limit": 20,
"list": [
{
"id": "2303546",
"pol": { "code": "CNSHA", "name": "Shanghai", "name_en": "shanghai" },
"pod": { "code": "USLSA", "name": "Los Angeles", "name_en": "los angeles,ca" },
"carrier": { "code": "MAT", "name": "Matson" },
"warehouse": { "code": "JGC", "name": "Bonded Warehouse" },
"transit": {
"is_direct": false,
"days": 11,
"port": "Los Angeles",
"port_en": "Los Angeles,ca"
},
"schedule": {
"cutoff_date": "2026-05-25",
"departure_date": "2026-05-27",
"arrival_date": "2026-06-07"
},
"price": {
"value": 187,
"unit": "CNY/W/M",
"weight_ratio": "1:750"
},
"local_fee": {
"type": "AMS",
"price": 25,
"remark": ""
},
"remark": "<=5RT",
"updated_at": "2026-02-09"
}
]
},
"credit_used": 1,
"credit_balance": 9498
}Billing tip:Actual booking cost =
max(weight_in_tons, volume_in_cbm) × price_per_wm + POL surcharges + destination port fees, with a minimum of min_charge.