Goldika APIgoldika.ir ↗
Get real-time 18-karat gold buy and sell prices per gram in Toman from goldika.ir. Single endpoint, two price fields, updates throughout trading hours.
What is the Goldika API?
The Goldika.ir API exposes 1 endpoint — get_gold_price — that returns the current buy and sell prices for 18-karat gold per gram, denominated in Iranian Toman. The response delivers 3 fields: buy, sell, and unit, giving you everything needed to display or compare live gold prices without any pagination or filtering required.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/7f07c63d-7549-4815-bd4a-233f2611a08b/get_gold_price' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace goldika-ir-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Goldika SDK — fetch current 18k gold prices in Toman."""
from parse_apis.goldika_ir_api import Goldika, ParseError
client = Goldika()
# Fetch the current buy/sell prices for 18-karat gold (per gram).
try:
price = client.gold_prices.get()
except ParseError as e:
print(f"Could not retrieve gold price: {e.code}")
raise
print(f"Buy: {price.buy:,.0f} Toman/gram")
print(f"Sell: {price.sell:,.0f} Toman/gram")
print(f"Unit: {price.unit}")
print("exercised: gold_prices.get")
Returns the current buy and sell prices for 18-karat gold (per gram) in Toman. One upstream request; no pagination. Prices update frequently throughout trading hours.
No input parameters required.
{
"type": "object",
"fields": {
"buy": "Current buy price per gram of 18k gold in Toman (number)",
"sell": "Current sell price per gram of 18k gold in Toman (number)",
"unit": "Always 'geram18' indicating the price unit is one gram of 18k gold"
},
"sample": {
"data": {
"buy": 21811325.6,
"sell": 21294061,
"unit": "geram18"
},
"status": "success"
}
}About the Goldika API
What the API Returns
The get_gold_price endpoint returns the current market prices for 18-karat gold on goldika.ir. The response includes two price fields — buy and sell — each representing the per-gram price in Iranian Toman. A third field, unit, is always set to 'geram18', confirming the unit of measure is one gram of 18-karat gold. There are no required input parameters; a single call returns all available data.
Price Freshness
Prices on goldika.ir update frequently during active trading hours, so repeated calls to get_gold_price will reflect near-real-time market movements. Outside of trading hours, prices reflect the last published values from the source. There is no timestamp field in the response, so downstream applications tracking price history should record their own call timestamps.
Response Shape
The response is minimal and flat: { buy: number, sell: number, unit: 'geram18' }. The spread between buy and sell represents the dealer margin visible on goldika.ir at the time of the request. Both values are raw numbers in Toman — no currency conversion or formatting is applied.
The Goldika API is a managed, monitored endpoint for goldika.ir — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when goldika.ir changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official goldika.ir API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Display live 18K gold buy/sell prices on a Persian-language financial dashboard
- Alert users when the spread between
buyandsellexceeds a defined threshold - Log periodic
buyandsellsnapshots to build a historical gold price dataset in Toman - Feed current gold prices into a jewelry pricing calculator that adjusts product costs in Toman
- Compare goldika.ir's
sellprice against other Iranian gold market sources for arbitrage signals - Power a Telegram or mobile bot that reports the latest 18K gold price on demand
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does goldika.ir have an official developer API?+
What exactly does the `unit` field in the response mean?+
unit field is always the string 'geram18', indicating that both the buy and sell prices represent the cost of one gram of 18-karat (750 fineness) gold in Iranian Toman. It is a fixed identifier, not a variable you can change.Does the API return a timestamp showing when the prices were last updated?+
get_gold_price response. The API returns buy, sell, and unit only. If your application needs time-series data, you should record the timestamp of each API call on your end.Does the API cover gold karats other than 18K, or gold coin prices?+
unit: 'geram18' field. Gold coin prices, 24K, or other karat weights are not included. You can fork this API on Parse and revise it to add endpoints for those additional gold types.