{"uid":"cap_ITRcObwFIiZdcPW4pOqti","slug":"try-madhousewallet-com-7eb0fd1c","name":"Madhouse Wallet Payout Requirements","description":"Convert USDC to 45+ local currencies and receive funds directly to your bank account. Fast, secure crypto offramp powered by Madhouse Wallet.","url":"https://try.madhousewallet.com/api/public/requirements","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["currency"],"properties":{"currency":{"type":"string","description":"ISO 4217 currency code to fetch payout requirements for, e.g. NGN, KES, EUR, INR."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data"],"properties":{"data":{"type":"array","description":"Account types for the currency. Each item has: type (string id to pass when creating a recipient), title (string), and fields (array of groups; each group has name and a group array of field descriptors with key, name, type one of text/select/radio/date, required, refreshRequirementsOnChange, optional minLength/maxLength/validationRegexp/example and valuesAllowed for select/radio)."}}}}}}},"responseSchema":{"type":"json","example":{"data":[{"type":"nigeria_bank_account","title":"Bank account","fields":[{"name":"Recipient bank details","group":[{"key":"bankCode","name":"Bank","type":"select","required":true,"valuesAllowed":[{"key":"058","name":"GTBank"}],"refreshRequirementsOnChange":true},{"key":"accountNumber","name":"Account number","type":"text","required":true,"maxLength":10,"minLength":10,"refreshRequirementsOnChange":false}]}]}]}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"currency":"NGN"}}},"response":{"_truncated":true,"_originalSize":13312}},"exampleRequest":{"currency":"NGN"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KO1dWCogFClu_0Gm_q1k5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the dynamic bank-detail field descriptors (with validation rules and allowed values) required to create a payout recipient for a given currency.","exampleAgentPrompt":"What bank details and fields do I need to collect from a recipient before I can send them money in Nigerian naira (NGN)?","exampleUseCases":null,"resultDescription":"An array of account types for the specified currency, each containing a type identifier (to use when creating a recipient), a human-readable title, and an array of field groups. Each field group contains descriptors with key, name, input type (text/select/radio/date), required flag, refreshRequirementsOnChange flag, and optional validation rules (minLength, maxLength, validationRegexp, example) plus allowed values for select/radio fields.","failureModes":["Missing or invalid currency code returns an error or empty result","Unsupported currency code may return no account types","Network or payment (x402) failures if USDC payment is not properly handled","Rate limiting or authorization errors if the x402 micropayment is rejected"],"whenToPreferThis":"Use this endpoint before creating a payout recipient via the /api/public/create-recipient endpoint — it tells you exactly which fields and account types are valid for the target currency, preventing validation errors downstream. Choose this when building dynamic payout forms or automating recipient onboarding for cross-border transfers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:44:55.330Z","isFirstParty":false}