AlQuran Cloud

Quran text, translations and editions from the AlQuran Cloud API. Machine-payable per request.

Robinhood Chain

Offers

Offer	Endpoint	Price
Ayah lookup Returns a single ayah by number or reference. Append a path such as /262 or /2:255.	`/m/alquran-cloud/ayah`	0.002 USDG
List editions Returns all available Quran text and translation editions as JSON.	`/m/alquran-cloud/editions`	0.001 USDG
List surahs Returns metadata for all 114 surahs of the Quran as JSON.	`/m/alquran-cloud/surahs`	0.002 USDG

Machine-readable: openapi.json with x-payment-info offers.

Try it live

Run the full MPP flow from your browser: catch the 402, sign the payment with your wallet, and watch it settle on-chain.

Pay with an agent

Any MPP or x402-compatible client works. With mppx, payment is automatic:

// x402 exact scheme (permit2) on Robinhood Chain
// 1. GET the endpoint, read the payment-required header (base64 JSON)
// 2. Sign PermitWitnessTransferFrom against Permit2 for the advertised offer
//    (spender = x402ExactPermit2Proxy, witness.to = merchant wallet)
// 3. Retry with the payment-signature header; settlement tx arrives
//    in the payment-response header
const res = await fetch('https://api.meshgateway.co/m/alquran-cloud/ayah', {
  headers: { 'payment-signature': signedPaymentPayload },
})

Or inspect the challenge yourself:

curl -i https://api.meshgateway.co/m/alquran-cloud/ayah
# HTTP/1.1 402 Payment Required
# WWW-Authenticate: Payment id="…", method="evm", intent="charge", …