{"uid":"cap_fH8Xoi2WJTSywS7kDMXUM","slug":"latamref-latin-american-government-reference-data-webhook-alert-6f1572ad","name":"latamref - Latin American Government Reference Data Webhook Alert Registration","description":"Authoritative Latin American government reference values as clean JSON: central-bank policy rates, VAT rates, national minimum wages and public holidays for Argentina (ar), Brazil (br), Chile (cl), Colombia (co), Costa Rica (cr), Dominican Republic (do), Ecuador (ec), Guatemala (gt), Mexico (mx), Peru (pe), Paraguay (py), Uruguay (uy). Every value carries a citation to its official primary source (government gazette or central-bank statement), an effective date, a last-confirmed date and a staleness flag.","url":"https://latamref.dev/alerts","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["url","series"],"properties":{"url":{"type":"string","format":"uri","description":"Webhook endpoint for series.changed events"},"series":{"type":"array","items":{"type":"string"},"description":"Patterns like \"ar/policy-rate\", \"bb/*\", or \"*\""}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["id","url","series","secret"],"properties":{"id":{"type":"string"},"url":{"type":"string"},"active":{"type":"boolean"},"secret":{"type":"string","description":"HMAC-SHA256 signing secret — shown once"},"series":{"type":"array","items":{"type":"string"}},"created":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"id":"3f6a1c2e-0000-4000-8000-000000000000","url":"https://example.com/webhook","active":true,"secret":"hex-encoded-hmac-secret","series":["ar/policy-rate"],"created":"2026-07-15T12:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fiZes5txWeEFIdeodYn3I","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Registers a webhook to receive real-time alerts when Latin American government reference data series (policy rates, VAT, minimum wages, holidays) change","exampleAgentPrompt":"Set up a webhook at https://my-app.com/hooks/latam so I get notified whenever the Argentina policy rate or Mexico minimum wage series changes on latamref.","exampleUseCases":[{"title":"Central bank rate change monitoring","prompt":"Register my endpoint https://finance-app.io/webhooks/latam to receive alerts whenever the Brazilian or Argentine central bank policy rate series changes on latamref — send me the HMAC secret so I can verify the payloads."},{"title":"Payroll compliance VAT alert","prompt":"I need to be notified whenever the VAT rate changes for any Latin American country we operate in — can you subscribe my webhook at https://erp.mycompany.com/latam-alerts to the pattern br/*, mx/*, co/* on latamref?"},{"title":"Automated FX model refresh trigger","prompt":"Set up a latamref alert subscription pointing to https://quant-platform.dev/triggers/latamref for all policy-rate series across Latin America — use the wildcard pattern */policy-rate — so my model re-runs automatically when any central bank moves rates."}],"resultDescription":"Returns a subscription object containing a unique subscription ID (UUID), the registered webhook URL, an active boolean, a hex-encoded HMAC secret for verifying incoming webhook payloads, the list of subscribed series patterns, and the creation timestamp. When a monitored series changes, latamref will POST a series.changed event to the registered URL.","failureModes":["Invalid webhook URL format returns validation error","Unsupported series pattern (e.g. referencing a non-existent country code like bb/*) may create subscription but never fire events","Webhook endpoint unreachable — subscription created but delivery will fail silently or with retries","Duplicate subscriptions for same URL/series may be created if endpoint is not idempotent","Payment failure (x402) prevents subscription creation","Missing required fields (url or series) returns 400 bad request"],"whenToPreferThis":"Use this endpoint when you need to reactively trigger workflows or alerts the moment Latin American government reference values are updated, rather than polling the data endpoints repeatedly. Prefer this over scheduled polling when low-latency notification of policy rate, VAT, minimum wage, or public holiday changes is required for compliance, financial modeling, or payroll systems.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:39:19.324Z","isFirstParty":false}