An API of Ice and Fire

Books, houses and characters from the A Song of Ice and Fire universe. Machine-payable per request.

Robinhood Chain

Offers

Offer	Endpoint	Price
Books Returns the novel series metadata as JSON.	`/m/ice-and-fire/books`	0.001 USDG
Characters Returns characters. Append /583 or pass ?name=Jon%20Snow.	`/m/ice-and-fire/characters`	0.002 USDG
Houses Returns Westeros houses. Append /378 for one record or pass ?region=The%20North.	`/m/ice-and-fire/houses`	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/ice-and-fire/books', {
  headers: { 'payment-signature': signedPaymentPayload },
})

Or inspect the challenge yourself:

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