API's for the diamond industry

Real Time Price Calculator API

Overview: Via the Diamond Prices API, you may query our real time database of average asking prices for single polished diamonds, based on the following diamond parameters: Cut (Shape), Carat, Color, Clarity, Make (Cut Grade), Certificate.

HTTP

HTTP Request returns XML
Endpoint: http://www.idexonline.com/DPService.asp

Input Parameters

There are a number of parameters that can be used for this API.
Parameter Allowed Values Format Description
Cut Round, Marquise, Pear, Oval, Heart, Emerald, Princess, Radiant, Triangle, Baguette, Asscher, Cushion String Shape of the diamond cut
Carat Numeric, e.g. 1.10 Decimal Carat weight
Color D, E, F, G, H, I, J, K, L, M, N, O, P String Color grade
Clarity IF, VVS1, VVS2, VS1, VS2, SI1, SI2, SI3, I1, I2, I3 String Clarity grade
Make Ideal, Excellent, Very Good, Good, Fair, Poor String Quality of the diamond, cut grade
Certificate / Cert AGS, CEGL, CGI, CGL, DCLA, EGL Asia, EGL Intl., EGL USA, GCAL, GIA, HRD, IGI String Gemological laboratory that issued the grading report

Output Data Explained

The output format for this API is in JSON format.
For an overview of diamond properties click here.
Parameter Meaning Format
price Current Average Trading Price in USD / carat Integer
min Average of lowest 10% asking price in USD / carat Integer
max Average of 10% highest asking price in USD / carat Integer
avg Average asking price of the last 3 months in USD / carat Integer
count Amount of diamonds now available Integer
link Link to IDEX Trading Platform String

Sample Request

HTTP GET 
	GET http://www.idexonline.com/DPService.asp?SID=4wp7go123jqtkdyd5f2e&cut=Round&carat=1.00&color=E&clarity=VS1&make=Excellent&cert=GIA

Sample Response

XML String 
<pr>
	<price>7651</price>
	<min>5844</min>
	<max>10079</max>
	<avg>7629</avg>
	<count>698</count>
	<link>
		http://www.idexonline.com/SearchDiamondsResults.aspx?SID=y9sy123tgy2kos3rvm0h&go_trade=^3^16^2^7^3^2
	</link>
</pr>

© IDEX 2024, www.idexonline.com