WallGold APIwallgold.ir ↗
Get real-time 18-karat gold buy and sell prices in Iranian Toman from WallGold.ir. Single endpoint, no inputs required, returns buy, sell, and unit fields.
What is the WallGold API?
The WallGold.ir API exposes 1 endpoint, get_gold_price, that returns the current buy and sell prices for 18-karat gold in Iranian Toman. Each response carries three fields — buy, sell, and unit — sourced from WallGold's live pricing feed. No query parameters or authentication inputs are required to call the endpoint, making it straightforward to integrate into any gold price monitoring workflow.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/8d217ac9-aca1-4789-9b51-927fb06f728d/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 wallgold-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: WallGold SDK — fetch live 18k gold prices from wallgold.ir."""
from parse_apis.wallgold_ir_api import WallGold, UpstreamError
client = WallGold()
# Fetch current 18-karat gold buy/sell prices in Toman
try:
price = client.gold_prices.get()
except UpstreamError as e:
print(f"Upstream feed unavailable: {e}")
raise
print(f"Buy: {price.buy:,} Toman/gram")
print(f"Sell: {price.sell:,} Toman/gram")
print(f"Unit: {price.unit}")
print("exercised: gold_prices.get")
Returns the current 18-karat gold buy and sell prices in Toman. Both prices are fetched from the platform's live pricing feed. No inputs required.
No input parameters required.
{
"type": "object",
"fields": {
"buy": "integer — current buy price per gram of 18k gold in Toman",
"sell": "integer — current sell price per gram of 18k gold in Toman",
"unit": "string — always 'geram18'"
},
"sample": {
"data": {
"buy": 21703000,
"sell": 21704000,
"unit": "geram18"
},
"status": "success"
}
}About the WallGold API
What the API Returns
The single get_gold_price endpoint returns three fields: buy (integer), sell (integer), and unit (string). Both buy and sell represent per-gram prices in Iranian Toman for 18-karat gold. The unit field is always 'geram18', confirming the karat and weight basis of both prices. No inputs are accepted — the endpoint always returns the current live quote.
Interpreting Buy vs. Sell
The buy price reflects what the market offers to purchase gold from a seller, while sell reflects what a buyer would pay to acquire it. The spread between these two integers is a direct indicator of market liquidity and dealer margin at any given moment. Both values update in line with WallGold's live feed, so repeated calls within a session can reflect intraday price movement.
Scope and Limitations
Coverage is limited to 18-karat gold priced in Toman. Other karat grades (24k, 21k), gold coins (e.g., Bahar Azadi), foreign currency rates, and historical time-series data are not part of the current response shape. The API delivers a snapshot of the current price; it does not paginate or stream historical records.
The WallGold API is a managed, monitored endpoint for wallgold.ir — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when wallgold.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 wallgold.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 in a Persian-market trading dashboard
- Alert users when the spread between
buyandsellexceeds a defined threshold - Log periodic
buyandsellsnapshots to build an in-house price history database - Power a mobile app widget showing the current gold price in Toman for Iranian users
- Feed gold price data into a personal finance app that tracks asset values in Toman
- Compare WallGold's
sellprice against other Iranian gold dealers for arbitrage monitoring
| 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 WallGold.ir have an official developer API?+
What exactly does `get_gold_price` return?+
buy (integer, per-gram buy price in Toman), sell (integer, per-gram sell price in Toman), and unit (always the string 'geram18'). No inputs are needed. The values reflect the current live quote at the time of the call.Does the API cover gold karat grades other than 18k, or gold coins like Bahar Azadi?+
get_gold_price endpoint. You can fork this API on Parse and revise it to add endpoints for other karat grades or coin types if WallGold exposes that data.Can I retrieve historical gold price data through this API?+
get_gold_price endpoint returns only the current live price snapshot. It does not return historical records or time-series data. You can fork this API on Parse and revise it to add a history endpoint if that data becomes available from the source.How fresh is the price data returned by `get_gold_price`?+
buy and sell values reflect WallGold's live pricing feed at the moment the request is made. There is no explicit timestamp field in the response, so callers should record their own request time if they need to correlate prices with a specific moment.