# Colombia TRM x402 — Official USD/COP Exchange Rate

> Colombia TRM x402 — Official USD/COP Exchange Rate is a paid API for AI agents from x402.lagaceta.net, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns the official Colombian Tasa Representativa del Mercado (TRM) USD/COP exchange rate from Superintendencia Financiera and BanRep, paid via x402 micropayment.

## Facts

- Endpoint: GET https://x402.lagaceta.net/trm
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/colombia-trm-x402-official-usd-cop-exchange-rate-17acd0d2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MqRCjPSTi7SaDACN_Oo8y

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability colombia-trm-x402-official-usd-cop-exchange-rate-17acd0d2
```

Example prompt: What's the official Colombian TRM rate for USD to COP right now — the one from Superintendencia Financiera?

## When to prefer this

Choose this endpoint when you need the official, legally-recognized Colombian TRM exchange rate published by Superintendencia Financiera or BanRep — particularly for financial compliance, invoicing, accounting, tax filings, or regulated fintech applications in Colombia. Prefer this over commercial FX feeds (e.g. OpenExchangeRates, Fixer.io) when the official government rate is legally required or preferred. The x402 micropayment model makes it cost-effective for per-call usage without subscription overhead.

## Known failure modes

- Payment not received — returns HTTP 402 if x402 micropayment of $0.005 USDC on Base is not completed
- Source unavailable — Superintendencia Financiera or BanRep data feed may be temporarily down
- Stale rate — rate may reflect the previous business day if queried outside Colombian banking hours
- Invalid mode parameter — missing or incorrect 'mode' query param may return an error
- Network timeout — upstream government data source may be slow to respond

## How this service works

Official Colombian TRM (Tasa Representativa del Mercado) USD/COP. Prepaid x402 $0.005 USDC on Base. Superintendencia Financiera + BanRep live.

## Output

A JSON object with a boolean ok status, the currency pair string (e.g. 'USDCOP'), the official TRM rate as a decimal number (e.g. 3128.65), the source identifier (e.g. 'superfinanciera_datos_gov_co'), and the ISO 8601 timestamp from which the rate is valid.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "pair": "USDCOP",
  "rate": 3128.65,
  "source": "superfinanciera_datos_gov_co",
  "valid_from": "2026-08-15T00:00:00.000"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/colombia-trm-x402-official-usd-cop-exchange-rate-17acd0d2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.lagaceta.net](https://www.zero.xyz/host/x402.lagaceta.net/llms.txt)