{ "openapi": "3.1.0", "info": { "title": "RemittancePulse API", "description": "Global remittance intelligence API covering the $700B+ annual global remittance market. 9 endpoints: corridor analysis (200+ corridors), provider comparison with true total cost (fee + FX markup), live ECB mid-market rate vs markup analysis, receive-country guides, mobile money ecosystem (M-Pesa/GCash/bKash/MTN MoMo/Wave), compliance and KYC intelligence, industry news, diaspora community intelligence, and stablecoin-rail comparison (USDC/USDT on Base/Solana/Tron vs traditional providers, with honest receiving-country cash-out reality). Provider comparison and rate endpoints include Wise/Remitly/Western Union/Xoom affiliate links (corridor-aware). All require x402 micropayment (USDC on Base).", "version": "1.3.0", "contact": { "name": "The Aslan Group LLC", "url": "https://pulsenetwork.theaslangroupllc.com", "email": "info@theaslangroupllc.com" }, "x-guidance": "# RemittancePulse API (x402 pay-per-call)\n\nGlobal remittance intelligence API. 9 endpoints covering 200+ corridors: corridor analysis (best providers, fees, receive options), provider comparison with true total cost including FX markup, live ECB mid-market rate analysis, receive-country guides (mobile money/cash/bank), mobile money ecosystem (M-Pesa/GCash/bKash/MTN MoMo/Wave), KYC/AML compliance, industry news, diaspora community intelligence, and stablecoin-rail comparison (USDC/USDT on Base/Solana/Tron vs traditional providers, with ho\n\nBase URL: https://remittancepulse.theaslangroupllc.com\n\n## Payment\nAll paid endpoints use the x402 protocol (HTTP 402): USDC on Base mainnet (eip155:8453). No API keys, no accounts, no subscriptions — pay per call.\n\n## Agent workflow\n1. Request the endpoint. Unpaid requests receive a 402 challenge with exact price and pay-to details (the challenge is returned before request validation).\n2. Settle with any x402 client (agentcash fetch, x402-fetch, x402-axios) and retry with the X-PAYMENT header.\n3. Responses are JSON. Prices below are fixed per call.\n\n## Paid endpoints\n- GET /api/remit/corridor — $0.08 — Best providers for any send corridor — fees, FX markup, delivery speed, receive methods, World Bank benchmark, corridor tips.\n- GET /api/remit/compare — $0.1 — Side-by-side provider comparison — exact recipient amount for each provider, true total cost ranking (fee + FX markup), live ECB benchmark rate.\n- GET /api/remit/rate — $0.05 — Live ECB mid-market FX rate + provider markup analysis — shows exactly how much is lost to rate markups in dollar/pound/euro terms.\n- GET /api/remit/receive — $0.08 — Receiving-country guide — mobile wallet platforms, cash pickup networks, bank transfer options, banked population %, remittance as % GDP.\n- GET /api/remit/mobile — $0.08 — Mobile money ecosystem — M-Pesa, GCash, bKash, MTN MoMo, Airtel Money, Wave, OPay, STC Pay — user counts, receive from abroad, cashout options, interoperability\n- GET /api/remit/compliance — $0.1 — KYC tiers, send limits, AML reporting thresholds, corridor restrictions, FATF grey-listing status, and documentation checklist.\n- GET /api/remit/news — $0.08 — Regulatory changes, provider launches, fee trends, FATF updates, stablecoin remittance developments, mobile money expansion.\n- GET /api/remit/diaspora — $0.1 — Community-specific intelligence — Filipino OFW (balikbayan, Pasko surge), Indian diaspora, Mexican workers, Nigerian community — preferred providers, cultural p\n- GET /api/remit/stablecoin-rails — $0.12 — Stablecoin remittance rail comparison — USDC/USDT on Base, Solana, and Tron versus Wise, Western Union, and banks. Total cost including on-ramp, network fee, an\n- GET /api/remit/rights — $0.05 — Reg E Subpart B rights check — 180-day error window math, refund-or-resend election, fee add-back, 30-minute cancellation, §1005.33(h) five-prong rebuttal. Dete\n- GET /api/remit/rights-letter — $2 — Citation-locked error notice / typo-denial rebuttal / cancellation demand; CA §2102 stack; honest-no on dead windows.\n\nMore APIs from this provider: https://pulsenetwork.theaslangroupllc.com (grouped catalog, all x402)." }, "servers": [ { "url": "https://remittancepulse.theaslangroupllc.com" } ], "paths": { "/api/remit/corridor": { "get": { "summary": "Corridor intelligence", "description": "Best providers, fees, exchange rates, delivery options, and receive methods for any send corridor. Includes World Bank benchmark cost comparison and corridor-specific tips.", "operationId": "remitCorridor", "parameters": [ { "name": "from", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Sending country — e.g. USA, UAE, UK, Canada, Germany" }, { "name": "to", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Receiving country — e.g. Philippines, India, Mexico, Nigeria, Bangladesh" }, { "name": "amount", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Amount to send in source currency" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Corridor analysis with top providers and receive options" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.08, "x-agent-use-case": "on-demand", "x-agent-chaining": "Follow with /api/remit/compare for provider side-by-side cost comparison", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.080000" }, "protocols": [ { "x402": {} } ] } } }, "/api/remit/compare": { "get": { "summary": "Provider comparison", "description": "Side-by-side provider comparison showing true total cost (fee + FX markup). Uses live ECB mid-market rate as benchmark. Shows exactly how much the recipient gets with each provider.", "operationId": "remitCompare", "parameters": [ { "name": "from", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "to", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "amount", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Amount to send (default: 500)" }, { "name": "from_currency", "in": "query", "required": false, "schema": { "type": "string" }, "description": "e.g. USD, GBP, EUR, AED, CAD" }, { "name": "to_currency", "in": "query", "required": false, "schema": { "type": "string" }, "description": "e.g. PHP, INR, MXN, NGN, PKR" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Provider comparison with recipient amount and true cost ranking" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.1, "x-agent-use-case": "on-demand", "x-agent-chaining": "Pair with /api/remit/rate for live mid-market benchmark; response includes Wise/Remitly/WU affiliate links for immediate action", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/remit/rate": { "get": { "summary": "FX rate and markup analysis", "description": "Live ECB mid-market rate for any currency pair with provider markup analysis. Shows the hidden cost of exchange rate markups in dollar terms.", "operationId": "remitRate", "parameters": [ { "name": "from_currency", "in": "query", "required": true, "schema": { "type": "string" }, "description": "e.g. USD, GBP, EUR, AED — also accepts 'from'" }, { "name": "to_currency", "in": "query", "required": true, "schema": { "type": "string" }, "description": "e.g. PHP, INR, MXN, NGN — also accepts 'to'" }, { "name": "amount", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "FX rate intelligence with live rate and provider markup analysis" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.05, "x-agent-use-case": "on-demand", "x-agent-chaining": "Response includes provider affiliate links; follow with /api/remit/compare for full fee comparison", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] } } }, "/api/remit/receive": { "get": { "summary": "Receive-country guide", "description": "How recipients can best receive money in a specific country — mobile wallets, cash pickup networks, bank transfer options, ID requirements, and local infrastructure overview.", "operationId": "remitReceive", "parameters": [ { "name": "country", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" }, "description": "bank | cash | mobile | wallet — or omit for all methods" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Receive-country guide with platform specifics" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.08, "x-agent-use-case": "on-demand", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.080000" }, "protocols": [ { "x402": {} } ] } } }, "/api/remit/mobile": { "get": { "summary": "Mobile money ecosystem", "description": "Mobile money platforms by country or region — M-Pesa, GCash, bKash, MTN MoMo, Airtel Money, Wave, OPay, STC Pay and more. Includes how to receive international remittances, cashout options, and interoperability.", "operationId": "remitMobile", "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string" }, "description": "East Africa | West Africa | South Asia | Southeast Asia | Latin America | Middle East" }, { "name": "platform", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Specific platform — e.g. M-Pesa, GCash, bKash" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Mobile money ecosystem intelligence" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.08, "x-agent-use-case": "on-demand", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.080000" }, "protocols": [ { "x402": {} } ] } } }, "/api/remit/compliance": { "get": { "summary": "Compliance and KYC intelligence", "description": "KYC requirements, send limits, AML reporting thresholds, and corridor-specific restrictions. Covers FinCEN (US), FINTRAC (Canada), FCA (UK), AUSTRAC (Australia), and destination-country rules.", "operationId": "remitCompliance", "parameters": [ { "name": "from", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "amount", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "purpose", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Compliance intelligence with KYC tiers and corridor restrictions" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.1, "x-agent-use-case": "on-demand", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/remit/news": { "get": { "summary": "Remittance industry news", "description": "Real-time regulatory changes, provider launches, fee trend data, FATF updates, corridor alerts, and technology developments (stablecoin remittances, mobile money expansion).", "operationId": "remitNews", "parameters": [ { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "topic", "in": "query", "required": false, "schema": { "type": "string" }, "description": "regulatory | providers | fees | technology | all" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Remittance news intelligence" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.08, "x-agent-use-case": "scheduled", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.080000" }, "protocols": [ { "x402": {} } ] } } }, "/api/remit/diaspora": { "get": { "summary": "Diaspora community intelligence", "description": "Community-specific remittance intelligence — preferred providers, cultural sending patterns, seasonal spikes (Eid, Christmas, Diwali), community trust factors, and optimized strategies for Filipino OFW, Indian expat, Mexican, Nigerian, Pakistani, and other diaspora communities.", "operationId": "remitDiaspora", "parameters": [ { "name": "community", "in": "query", "required": true, "schema": { "type": "string" }, "description": "e.g. Filipino, Indian, Mexican, Nigerian, Pakistani, Bangladeshi, Vietnamese" }, { "name": "sending_from", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Country sending from — tailors corridor-specific advice" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Diaspora community remittance intelligence" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.1, "x-agent-use-case": "on-demand", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/remit/stablecoin-rails": { "get": { "summary": "Stablecoin remittance rail comparison", "description": "Compares USDC/USDT rails on Base, Solana, and Tron against traditional providers (Wise, Western Union, banks) for a send corridor. Shows total cost including on-ramp, network fee, and — the part that actually matters — the real off-ramp spread and cash-out friction in the receiving country.", "operationId": "remitStablecoinRails", "parameters": [ { "name": "from_country", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Sending country — e.g. USA, UAE, UK, Germany" }, { "name": "to_country", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Receiving country — e.g. Mexico, Philippines, India, Nigeria, Kenya" }, { "name": "amount", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Amount to send (default: 500)" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Stablecoin vs traditional rail comparison with off-ramp reality check" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.12, "x-agent-use-case": "on-demand", "x-agent-chaining": "Pair with /api/remit/compliance for KYC/AML context on the destination-country off-ramp; follow with /api/remit/compare for a traditional-rail-only cost check", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.120000" }, "protocols": [ { "x402": {} } ] } } }, "/api/remit/rights": { "get": { "summary": "Remittance-transfer rights check (Reg E Subpart B) — deterministic, no LLM", "description": "The money-transfer rights senders never use: 180-day error window from the disclosed Date Available, sender's-choice refund-or-resend within 1 business day of election, mandatory fee+tax refund on late/never-arrived transfers (12 CFR 1005.33(c)(2)(ii)(B)), the 30-minute full-refund cancellation (§1005.34), the five-prong §1005.33(h) rebuttal to \"you typed the wrong number\" denials, and the CA Fin. Code §2102 stack. Scope gates with honest-no for scams, business senders, ≤$15, domestic, and crypto rails.", "operationId": "remitRights", "parameters": [ { "name": "issue", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "principal", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fees_paid", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "amount_paid", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "disclosed_total_to_recipient", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "actually_received", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "figures_estimated", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "date_available", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payment_auth_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cancel_request_time", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "scheduled_advance", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "funds_picked_up", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "funded_with", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "send_date", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sender_state", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "business_sender", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "recipient_country", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sender_in_us", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "provider_warned_before_payment", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "notice_date", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Coverage, error type with pinpoint CFR citation, deadline math (report-by/90-day/3-day/1-day), remedy election with fee add-back, escalation path" }, "402": { "description": "Payment Required" } }, "x-price-usd": 0.05, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] } } }, "/api/remit/rights-check": { "get": { "summary": "Agent-tier preview of the $2 rights-letter — applicability verdict, deadlines, upsell", "description": "Same deterministic Reg E Subpart B engine as /api/remit/rights and /api/remit/rights-letter. Returns whether a citation-locked document (error notice / §1005.33(h) rebuttal / cancellation demand) is supportable on these facts, which type, the deadlines that gate it, and exactly what buying the $2 letter adds. No LLM. Built for buyers whose per-call spend cap can't clear $2.00.", "operationId": "remitRightsCheck", "parameters": [ { "name": "issue", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "principal", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fees_paid", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "date_available", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sender_state", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Applicability verdict (applicable, letter_type, deadlines, amounts), what_the_letter_adds, and upsell object pointing to /api/remit/rights-letter" }, "402": { "description": "Payment Required" } }, "x-price-usd": 0.25, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.250000" }, "protocols": [ { "x402": {} } ] } } }, "/api/remit/rights-letter": { "get": { "summary": "Citation-locked remittance document — error notice / §1005.33(h) rebuttal / cancellation demand ($2)", "description": "Runs the rights check, then drafts the supported document with the §1005.33(b) notice elements, elected remedy, provider deadlines, and computed amounts. California senders get the Fin. Code §2102 10-day-refund section. Honest-no when the 180-day window is dead — no letter is sold that arrives dead.", "operationId": "remitRightsLetter", "parameters": [ { "name": "issue", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "provider", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "principal", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "fees_paid", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "date_available", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sender_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "recipient_name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "transfer_reference", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "remedy_choice", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sender_state", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Letter JSON (letter_text, subject_line, escalation_path) + full engine result; supportable=false with explanation when nothing is defensible" }, "402": { "description": "Payment Required" } }, "x-price-usd": 2, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "2.000000" }, "protocols": [ { "x402": {} } ] } } } } }