Skip to content

Commit 6491642

Browse files
authored
Update README.md Commodity Examples
1 parent d851141 commit 6491642

1 file changed

Lines changed: 200 additions & 0 deletions

File tree

README.md

Lines changed: 200 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,206 @@ Try the Commodity Prices API directly in your browser.
7171

7272
Enter your API key, select a commodity and instantly view the JSON response.
7373

74+
## Commodity Examples
75+
76+
<details>
77+
<summary>Gold Price API Example</summary>
78+
79+
Get real-time and historical gold price data in JSON format.
80+
81+
**Example Request**
82+
83+
```text
84+
https://apidata.fin2dev.com/v1/commodities?key=YOUR_API_KEY&commodity_name=gold
85+
```
86+
87+
**Example Response**
88+
89+
```json
90+
{
91+
"result": {
92+
"output": [
93+
{
94+
"commodity_name": "gold",
95+
"commodity_unit": "usd/t oz",
96+
"commodity_price": "3367.12",
97+
"price_change_day": "12.45",
98+
"percentage_day": "0.37%",
99+
"datetime": "2025-08-26T11:23:00.000"
100+
}
101+
]
102+
}
103+
}
104+
```
105+
106+
Learn more: [Gold Price API](https://fin2dev.com/blog/gold-price-api/)
107+
108+
</details>
109+
110+
<details>
111+
<summary>Silver Price API Example</summary>
112+
113+
Get silver price data for financial dashboards, market analysis and commodity tracking tools.
114+
115+
**Example Request**
116+
117+
```text
118+
https://apidata.fin2dev.com/v1/commodities?key=YOUR_API_KEY&commodity_name=silver
119+
```
120+
121+
**Example Response**
122+
123+
```json
124+
{
125+
"result": {
126+
"output": [
127+
{
128+
"commodity_name": "silver",
129+
"commodity_unit": "usd/t oz",
130+
"commodity_price": "34.90",
131+
"price_change_day": "0.21",
132+
"percentage_day": "0.61%",
133+
"datetime": "2025-08-26T11:23:00.000"
134+
}
135+
]
136+
}
137+
}
138+
```
139+
140+
</details>
141+
142+
<details>
143+
<summary>Oil Price API Example</summary>
144+
145+
Get crude oil price data including price changes and market performance indicators.
146+
147+
**Example Request**
148+
149+
```text
150+
https://apidata.fin2dev.com/v1/commodities?key=YOUR_API_KEY&commodity_name=crude_oil
151+
```
152+
153+
**Example Response**
154+
155+
```json
156+
{
157+
"result": {
158+
"output": [
159+
{
160+
"commodity_name": "crude oil",
161+
"commodity_unit": "usd/bbl",
162+
"commodity_price": "63.72",
163+
"price_change_day": "-1.08",
164+
"percentage_day": "-1.67%",
165+
"datetime": "2025-08-26T11:23:00.000"
166+
}
167+
]
168+
}
169+
}
170+
```
171+
172+
</details>
173+
174+
<details>
175+
<summary>Natural Gas Price API Example</summary>
176+
177+
Get natural gas price data for energy market applications and analytics tools.
178+
179+
**Example Request**
180+
181+
```text
182+
https://apidata.fin2dev.com/v1/commodities?key=YOUR_API_KEY&commodity_name=natural_gas
183+
```
184+
185+
**Example Response**
186+
187+
```json
188+
{
189+
"result": {
190+
"output": [
191+
{
192+
"commodity_name": "natural gas",
193+
"commodity_unit": "usd/mmbtu",
194+
"commodity_price": "2.91",
195+
"price_change_day": "0.04",
196+
"percentage_day": "1.39%",
197+
"datetime": "2025-08-26T11:23:00.000"
198+
}
199+
]
200+
}
201+
}
202+
```
203+
204+
</details>
205+
206+
<details>
207+
<summary>Metal Price API Example</summary>
208+
209+
Get industrial metal price data such as copper, aluminum and lithium.
210+
211+
**Example Request**
212+
213+
```text
214+
https://apidata.fin2dev.com/v1/commodities?key=YOUR_API_KEY&commodity_name=copper
215+
```
216+
217+
**Example Response**
218+
219+
```json
220+
{
221+
"result": {
222+
"output": [
223+
{
224+
"commodity_name": "copper",
225+
"commodity_unit": "usd/lbs",
226+
"commodity_price": "4.43",
227+
"price_change_day": "0.03",
228+
"percentage_day": "0.68%",
229+
"datetime": "2025-08-26T11:23:00.000"
230+
}
231+
]
232+
}
233+
}
234+
```
235+
236+
Learn more: [Metal Price API](https://fin2dev.com/blog/metal-price-api/)
237+
238+
</details>
239+
240+
<details>
241+
<summary>Agricultural Commodities Price API Example</summary>
242+
243+
Get agricultural commodity price data such as corn, wheat and coffee.
244+
245+
**Example Request**
246+
247+
```text
248+
https://apidata.fin2dev.com/v1/commodities?key=YOUR_API_KEY&commodity_name=corn
249+
```
250+
251+
**Example Response**
252+
253+
```json
254+
{
255+
"result": {
256+
"output": [
257+
{
258+
"commodity_name": "corn",
259+
"commodity_unit": "usd/bu",
260+
"commodity_price": "4.21",
261+
"price_change_day": "-0.02",
262+
"percentage_day": "-0.47%",
263+
"datetime": "2025-08-26T11:23:00.000"
264+
}
265+
]
266+
}
267+
}
268+
```
269+
270+
Learn more: [Agricultural Commodities Price API](https://fin2dev.com/blog/agricultural-commodities-price-api/)
271+
272+
</details>
273+
74274
## Code Examples
75275

76276
<details>

0 commit comments

Comments
 (0)