# Toolrail Colombia TRM (COP/USD Official Rate)

> Toolrail Colombia TRM (COP/USD Official Rate) is a paid API for AI agents from toolrail.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-12).

Returns Colombia's official TRM (Tasa Representativa del Mercado) COP/USD exchange rate with its validity dates, as published by the Superintendencia Financiera de Colombia.

## Facts

- Endpoint: GET https://toolrail.dev/co/trm?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/toolrail-colombia-trm-cop-usd-official-rate-a27badbc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_x1vxEjW3Ntx5qjluLSYYw

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 toolrail-colombia-trm-cop-usd-official-rate-a27badbc
```

Example prompt: What is Colombia's official TRM rate today — the COP/USD rate I should use for my tax invoice?

## When to prefer this

Use this endpoint when you need the official, legally binding COP/USD exchange rate (TRM) published by Colombia's Superintendencia Financiera — required for Colombian tax returns, DIAN invoices, legal contracts, and financial statements. Prefer this over generic FX rate APIs when legal compliance or Colombian regulatory accuracy is mandatory. For other LATAM currencies in a single call, consider the sibling LATAM exchange rates endpoint.

## Known failure modes

- Rate not yet published for the current day (e.g. early morning before SFC publishes) — may return previous day's rate or an error
- Upstream SFC data source unavailable — service may return a 5xx error
- Payment failure via x402 micropayment protocol — returns 402 if payment is not completed

## How this service works

Colombia's official TRM (Tasa Representativa del Mercado) — the legal COP/USD rate used for taxes and contracts, with validity dates. Use when you need the official COP/USD rate for Colombian taxes, invoices or contracts.

## Output

A JSON object containing the TRM value (número), validity start date (vigente_desde), currency code (moneda), country (pais), indicator name (indicador), and official source (fuente). This is the legally recognised COP/USD rate set by the Superintendencia Financiera de Colombia.

## Request schema (JSON Schema)

```json
{
 "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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "pais": {
       "type": "string"
      },
      "valor": {
       "type": "number"
      },
      "fuente": {
       "type": "string"
      },
      "moneda": {
       "type": "string"
      },
      "indicador": {
       "type": "string"
      },
      "vigente_desde": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

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