Port of Loading

Break down trade shipments by their port of origin. Monitor activity by shipping hubs and gain insights into export logistics and route efficiency.
ENDPOINTS
POST /api/v1/reportLoadingPort

Request parameters

sort

string

Field to sort by transactionCount, weight, or amount.

  • Example: "count","weight","amount"

order

string

Asc for ascending, desc for descending.

  • Example: "desc"

page

int

Page number (min: 1, max: 500)

  • Example: 10

page_size

int

Page size (default: 10, max: 20)

  • Example: 20
Request Example
{
  "data_coverage": 1,
  "date_range": [20231012, 20251212],
  "product_keyword": ["led"],
  "order": "desc",
  "sort": "count",
  "page_size": 10,
  "page": 1
}
curl https://api.tradedata.io/api/v1/reportLoadingPort \
  -H "Authorization: Bearer yourTokenHere" \
  -H "Content-Type: application/json" \
  -d '{"data_coverage": 1, "date_range": [20231012, 20251212], "product_keyword": ["led"], "order": "desc", "sort": "count", "page_size": 10, "page": 1}'

Response parameters

statusCode

int

Status code

  • Example: 200

data

array

Result container

entityObject

Json

Each field in the entityObject contains:

loadingPort

string

Port of Loading/Origin

  • Example: "Busan"

totalSuppliers

int

Number of buyers

  • Example: 133

totalQuantity

float

Total quantity of goods (aggregated)

  • Example: 212.72

totalWeight

float

Total shipment weight (aggregated, kg)

  • Example: 342.72

totalAmount

float

Total trade amount (aggregated,USD)

  • Example: 523.83

transactionCount

int

Total number of trade records or shipments

  • Example: 352

total

int

Total number of grouped records returned in this result set

  • Example: 509
Response Example
{
  "code": 200,
  "success": true,
  "data": [
    {
      "loadingPort": "SHEKOU",
      "totalSuppliers": 300,
      "totalQuantity": 0,
      "totalWeight": 1376448.31,
      "totalAmount": 1277585.79,
      "transactionCount": 2309
    }
  ],
  "msg": "success",
  "total": 509,
  "pageSize": 10,
  "current": 1,
  "sumResult": {
    "totalAmount": 1010853344.11,
    "totalQuantity": null,
    "totalSuppliers": 1513,
    "totalWeight": 786769765.13,
    "transactionCount": 27141
  }
}