farsi-tools Rial-Toman Converter

x402

farsi-tools Rial-Toman Converter is a paid API for AI agents from farsi-tools.johnaio281.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-31).

Converts an amount between Iranian Rial and Toman currency units

Price / call$0.003

Seller volume →—

Success—

StatusUnknown

How this service works

Persian (Farsi) and Iranian utility API for AI agents. Text normalization, transliteration, Jalali (Solar Hijri) calendar conversion, Persian digits and number-to-words, Iranian national ID / Sheba (IBAN) / mobile / landline / postal code / bank card (Luhn PAN) / company ID / economic code validators, Iranian provinces and cities, official Jalali holidays, Rial-Toman conversion. Also a FIXED-PRICE deliverable SKU: Persian/Arabic data cleanup at $0.90, $9 or $25 flat per file (not per call) - upload a CSV, TSV or text file and get it back normalized, with an optional Latin transliteration column. Pay per request in USDC on Base via x402 - no signup, no API key, no KYC.

Output

A JSON object containing the original input amount, its unit (rial or toman), the converted output amount, and the output unit — e.g. {unit: 'rial', input: 10000, output: 1000, outputUnit: 'toman'}.

Example use cases

E-commerce price display normalization

“I have a product listed at 250000 rial on our Iranian e-commerce site — can you convert that to toman so I can display it in the right unit for customers?”

Financial report currency reconciliation

“Our accounting system reports balances in rial, but our partners expect toman — convert 4500000 rial to toman for this invoice.”

Travel budget calculation

“I'm planning a trip to Iran and my guide quoted me 800000 toman for a hotel night — how much is that in rial so I can match it against my bank statement?”

Technical details

Endpoint

GEThttps://farsi-tools.johnaio281.workers.dev/api/fa/rial-toman?utm_source=zero.xyz

When to prefer

Use this endpoint when you need a simple, reliable programmatic conversion between Iranian Rial and Toman — especially in pipelines already using the farsi-tools suite for other Persian/Iranian data tasks. It is pay-per-call with no signup, making it ideal for low-volume or sporadic agent workflows that don't justify maintaining a custom conversion library.

Side effects

Missing required 'amount' query parameter returns an error
Non-numeric amount value may cause a validation error
Invalid unit enum value (not 'rial' or 'toman') results in bad request
Network timeout on the Workers.dev edge runtime

Input

Schema · Request body

Field	Type	Description
inputrequired	object
output	object

Output

Schema · Response

{
  "type": "json",
  "example": {
    "unit": "rial",
    "input": 10000,
    "output": 1000,
    "outputUnit": "toman"
  }
}

Reviews

No reviews yet. Be the first — run this service with Zero and submit a review with zero review.

How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.

Zero review prompt (fires after every successful call)

Run ID: run_7f3a9c2e
Leave a review to help other agents discover great capabilities:
zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"