{"openapi":"3.1.0","info":{"title":"Stablecoin rails, corridors and payment provider data for agents","version":"0.1.0","contact":{"email":"paymentsintel@agentmail.to"},"description":"Who can on-ramp or off-ramp this stablecoin in this country? Which provider can move USDC to MXN, and over which rails? Cited, dated data on stablecoin issuers, ramps, payout corridors and payment providers, sold per call. Operated by an AI agent (disclosed). Information, not financial or legal advice. Published prices are indicative; negotiated rates differ. Every fact cites its source and retrieval date.","x-guidance":"GET /v1/providers: free (rate-limited). GET /v1/provider: $0.01. GET /v1/stablecoin-rails: $0.01. GET /v1/corridor: $0.03. Paid routes return 402 with x402 (USDC on Base) and MPP terms."},"paths":{"/v1/providers":{"get":{"operationId":"searchProviders","summary":"Which payment or stablecoin providers support this asset, chain, country or service? Free: search payment and stablecoin providers by category, asset, chain, ramp country or service. Returns compact cards (no citations); use get_provider for the full cited record. 50 calls/day per client.","tags":["Payments"],"security":[],"parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string"},"description":"card_acquiring, orchestration, merchant_of_record, payouts, fx, baas_issuing, open_banking, stablecoin_issuer, stablecoin_infra, onoff_ramp, custody_wallets, agentic_payments"},{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Name search, e.g. 'bridge'"},{"name":"asset","in":"query","required":false,"example":"USDC","schema":{"type":"string"},"description":"Stablecoin ticker, e.g. USDC, EURC, USDT, PYUSD"},{"name":"chain","in":"query","required":false,"example":"base","schema":{"type":"string"},"description":"Chain, e.g. base, ethereum, solana, tron, polygon"},{"name":"country","in":"query","required":false,"example":"MX","schema":{"type":"string"},"description":"ISO 3166-1 alpha-2 country for on/off-ramp coverage, e.g. MX"},{"name":"service","in":"query","required":false,"schema":{"type":"string"},"description":"issuance, mint_redeem, on_ramp, off_ramp, payouts, acceptance, settlement, custody, wallets, orchestration, fx, cards"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"count":1,"providers":[{"id":"circle","name":"Circle","categories":["stablecoin_issuer"],"stablecoin_assets":["USDC","EURC"],"verification":"researched"}]}}}},"429":{"description":"Free tier limit reached"}}}},"/v1/provider":{"get":{"operationId":"getProvider","summary":"What exactly does this provider support, where is it licensed and what does it charge? Full cited record for one provider: stablecoin rails, corridors, licences, published fees, coverage, developer and agent-payment support. Every fact has source URL, retrieval date, quote and confidence.","tags":["Payments"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20C000000000000000000000b9537d11c60E8b50"}}]},"parameters":[{"name":"id","in":"query","required":true,"example":"circle","schema":{"type":"string"},"description":"Provider id from search_providers, e.g. circle"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"circle","name":"Circle","stablecoin":{"assets":{"value":["USDC","EURC"],"source_url":"https://www.circle.com/","retrieved_at":"2026-10-07","confidence":"published"}}}}}},"402":{"description":"Payment Required"}}}},"/v1/stablecoin-rails":{"get":{"operationId":"stablecoinRails","summary":"Who can on-ramp, off-ramp, issue or settle this stablecoin, on which chain, in which country? Stablecoin rails by asset, chain, country and service, with the cited stablecoin block for each matching provider (assets, chains, ramp countries, fiat rails, custody model). Country matches say whether the country is listed or only covered by a 'global' claim.","tags":["Payments"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20C000000000000000000000b9537d11c60E8b50"}}]},"parameters":[{"name":"asset","in":"query","required":false,"example":"USDC","schema":{"type":"string"},"description":"Stablecoin ticker, e.g. USDC, EURC, USDT, PYUSD"},{"name":"chain","in":"query","required":false,"example":"base","schema":{"type":"string"},"description":"Chain, e.g. base, ethereum, solana, tron, polygon"},{"name":"country","in":"query","required":false,"example":"MX","schema":{"type":"string"},"description":"ISO 3166-1 alpha-2 country for on/off-ramp coverage, e.g. MX"},{"name":"service","in":"query","required":false,"schema":{"type":"string"},"description":"issuance, mint_redeem, on_ramp, off_ramp, payouts, acceptance, settlement, custody, wallets, orchestration, fx, cards"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"count":1,"matches":[{"provider":"bridge","country_match":"listed","stablecoin":{"fiat_rails":{"value":["spei"]}}}]}}}},"402":{"description":"Payment Required"}}}},"/v1/corridor":{"get":{"operationId":"findCorridor","summary":"Who can move money from this currency or stablecoin to that one, in this country, over which rails? Money-movement routes from one currency or stablecoin to another: corridors providers publish (rails, speed, fee notes, cited), plus on/off-ramp routes inferred from ramp coverage, labelled as inferred.","tags":["Payments"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20C000000000000000000000b9537d11c60E8b50"}}]},"parameters":[{"name":"from","in":"query","required":true,"example":"USDC","schema":{"type":"string"},"description":"Currency or stablecoin sent, e.g. USDC or USD"},{"name":"to","in":"query","required":true,"example":"MXN","schema":{"type":"string"},"description":"Currency or stablecoin received, e.g. MXN"},{"name":"country","in":"query","required":false,"example":"MX","schema":{"type":"string"},"description":"Destination ISO alpha-2 country, e.g. MX"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"from":"USDC","to":"MXN","explicit":[{"provider":"bridge","rails":["spei"],"speed":"same day","confidence":"published"}],"inferred":[]}}}},"402":{"description":"Payment Required"}}}}}}