---
title: "US Trade Summary"
method: GET
path: "/us-trade/summary"
tags: ["Economics"]
---

# US Trade Summary

`GET /us-trade/summary`

## Request

- Base URL: `https://api.dataporium.io`
- URL: `https://api.dataporium.io/us-trade/summary`
- Auth: API key in query parameter `apikey`

Top US trading partners or product groups over a period (the last 12 months, this year so far, a year or a month), with exports, imports, balance, total trade and shares of the US total.

All filters are optional. The answer is {as_of, period, us_total, total, limit, offset, sort, order, rows, about}.

## Query parameters

- `dimension` string
- `period` string
- `year` integer
- `month` string
- `code` string
- `q` string
- `sort` string
- `order` string
- `limit` integer
- `offset` integer

## Response `200`

Successful response (JSON).

- object

## Other responses

- `401`: No API key in the request.
- `403`: The API key is not valid or has expired.

---

[API](https://skmtc.dev/dataporium/apis/dataporium-data-api.md) · [All operations](https://skmtc.dev/dataporium/apis/dataporium-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dataporium/apis/dataporium-data-api/revisions/8bc593179dc8?raw)