{"uid":"cap_1w7lXNk-dY4GBga486vQ9","slug":"farsi-tools-rial-toman-converter-d65d6721","name":"farsi-tools Rial-Toman Converter","description":"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.","url":"https://farsi-tools.johnaio281.workers.dev/api/fa/rial-toman?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["amount"],"properties":{"unit":{"enum":["rial","toman"],"type":"string"},"amount":{"type":["number","string"]},"number":{"type":["number","string"]}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"unit":"rial","input":10000,"output":1000,"outputUnit":"toman"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JcGkNlpgVHtMQa3i7IEWy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts an amount between Iranian Rial and Toman currency units","exampleAgentPrompt":"Convert 50000 rial to toman for me — I need to know the equivalent Toman amount.","exampleUseCases":[{"title":"E-commerce price display normalization","prompt":"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?"},{"title":"Financial report currency reconciliation","prompt":"Our accounting system reports balances in rial, but our partners expect toman — convert 4500000 rial to toman for this invoice."},{"title":"Travel budget calculation","prompt":"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?"}],"resultDescription":"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'}.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:37:56.969Z","isFirstParty":false,"canonicalSlug":"farsi-tools-rial-toman-converter-d65d6721"}