Want to use our widget ?

Want to test requests ?

We recommend the use of the awesome Postman which will allow you to simulate a HTTP request. You will then be able to generate code for your own programming language (click on Generate Code in the app to do so).

Define the frequency of the response (monthly, quarterly or yearly averaged)

Specific parameters for Customs Trade Data

Parameter

Default

Description

flow

data.info.spec.flows.default

Define the flow of the trade data you want to analyze. Possible values : import or export

country

global

Define the country of the trade data you want to analyze.Use : 2-letters code in data.request.major_countries. Nota : By default, we are displaying “Global” which is a weighted average of the major countries.

Dates

Start Date

if start_date is older than oldest_available_date, then start_date will be set at oldest_available_date

if start_date is more recent than latest_available_date, then response will be empty of values in the data.request.dataseries field.

End Date

Set the end date for the query.

By default, the end_date is set to the latest_available_date.

if end_date is more recent than latest_available_date, then end_date will be set at latest_available_date

if end_date is older than oldest_available_date, then response will be empty of values in the data.request.dataseries field.

Use the dates in your query, like this for instance : start_date=2016-06-22&end_date=2016-11-19

Period

Period parameter allows to request the dataseries in a different format.

For instance, if the original frequency of the commodity is M (monthly), you can query the request to get data averaged quarterly : Q.

Another example : if the original frequency is D (daily), you can then query for M or Q.

Period

Code

Daily

D

Monthly

M

Quarterly

Q

Currencies

Here are the currencies availalbles to get the commodities priced in your currency :

Name

Symbol

Code

Euro

€

EUR

US Dollar

$

USD

Australian dollar

AU$

AUD

Bulgarian lev

лв

BGN

Brazilian real

R$

BRL

Canadian dollar

$CA

CAD

Swiss franc

CHF

CHF

Chinese yuan renminbi

¥

CNY

Czech koruna

Kč

CZK

Danish krone

kr

DKK

UK pound sterling

£

GBP

Hong Kong dollar

HK$

HKD

Croatian kuna

kn

HRK

Hungarian forint

Ft

HUF

Indonesian rupiah

Rp

IDR

Israeli shekel

ILS

ILS

Indian rupee

INR

INR

Japanese yen

¥

JPY

Korean won (Republic)

₩

KRW

Mexican peso

MXN

MXN

Malaysian ringgit

RM

MYR

Norwegian krone

kr

NOK

New Zealand dollar

NZD

NZD

Philippine peso

₱

PHP

Polish zloty

zł

PLN

Romanian leu

lei

RON

Russian rouble

руб

RUB

Swedish krona

kr

SEK

Singapore dollar

SGD

SGD

Thai baht

฿

THB

Turkish lira

TRY

TRY

South African rand

R

ZAR

Use the code in your query, like this for instance : currency=CHFPlease note that we calculate the price of the commodity with the exchange rate at the time of price. It may seems obvious but it has already been asked by customers.

Units

We have different types of units for our API.

You first need to understand that our commodities have different units. Some are in metric tons, some in litre or MMBTU or even hour.And you cannot compare metric tons with hours for instance, so you need to understand before making the query what is type is the unit of the commodity you are working on.

Following are all the different types :

Volume

Unit

Ratio to Reference Unit

code

Barrel

0.1589870

1

Litre

0.001

5

Cubic meter

1 (this is the reference unit)

7

Bushel US

0.0352391

12

gallon US

0.0037854

14

Weight

Unit

Ratio to Reference Unit

code

Carat

0.0002

2

Gram

0.001

3

Kilogram

1 (this is the reference unit)

4

Metric ton

1000

10

Pound

0.4535923

11

Long ton

1016.05

15

Short ton

907.185

16

Troy ounce

0.0311035

17

Surface

Unit

Ratio to Reference Unit

code

Square meter

1 (this is the reference unit)

6

Count

Unit

Ratio to Reference Unit

code

Piece

1 (this is the reference unit)

8

Energy

Unit

Ratio to Reference Unit

code

MMBTU

293.071107

9

Kilowatt hour

1 (this is the reference unit)

20

Time

Unit

Ratio to Reference Unit

code

Hour

1 (this is the reference unit)

18

Month

720

19

Use the code in your query, like this for instance : unit=10 (only if base_code of unit is a weight)