{"openapi":"3.1.0","info":{"title":"Colombia TRM (Peso) FX API","version":"1.0.0","description":"Live official exchange-rate data for the Colombian peso (COP) — the Tasa Representativa del Mercado (TRM), Colombia's official daily USD/COP reference rate set by the financial regulator and published on the government open-data portal. Served as clean JSON, no key, no cache. Get the latest TRM (pesos per dollar and the inverse); look up the TRM in effect on any past date (the TRM stays valid across the weekend it was set, so any calendar date resolves to its effective rate); pull the daily TRM over any date range; or convert an amount between USD and COP at the latest TRM. Read live from Colombia's open-data portal, nothing cached. This is the official Colombian-peso reference rate — distinct from the ECB, BCRA, BCRP and other central-bank feeds and from market mid-rates: Colombia's own legally-binding USD/COP TRM.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/colombiatrm-api","description":"oanor gateway"}],"tags":[{"name":"Rate"},{"name":"Date"},{"name":"History"},{"name":"Convert"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/rate":{"get":{"operationId":"get_v1_rate","tags":["Rate"],"summary":"Latest TRM — pesos per dollar and the inverse","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"USD","quote":"COP","source":"Banco de la República (Colombia TRM)","valid_to":"2026-06-10","valid_from":"2026-06-10","cop_per_usd":3581.46,"usd_per_cop":0.0002792157},"meta":{"timestamp":"2026-06-10T22:58:00.063Z","request_id":"26a1523b-82c9-40fc-8094-73925c0f8198"},"status":"ok","message":"Rate retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/date":{"get":{"operationId":"get_v1_date","tags":["Date"],"summary":"The TRM in effect on a given date","description":"","parameters":[{"name":"date","in":"query","required":true,"description":"Date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-06-09"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"USD","date":"2026-06-09","quote":"COP","source":"Banco de la República (Colombia TRM)","valid_to":"2026-06-09","valid_from":"2026-06-06","cop_per_usd":3588.09,"usd_per_cop":0.0002786998},"meta":{"timestamp":"2026-06-10T22:58:00.360Z","request_id":"2a5ca479-effe-4c6b-af39-ea2eccd93856"},"status":"ok","message":"Rate retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/history":{"get":{"operationId":"get_v1_history","tags":["History"],"summary":"Daily TRM over a date range","description":"","parameters":[{"name":"from","in":"query","required":true,"description":"Start date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-05-01"},{"name":"to","in":"query","required":true,"description":"End date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-06-09"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"2026-06-09","base":"USD","from":"2026-05-01","count":24,"quote":"COP","source":"Banco de la República (Colombia TRM)","history":[{"date":"2026-05-01","cop_per_usd":3637.51},{"date":"2026-05-05","cop_per_usd":3707.58},{"date":"2026-05-06","cop_per_usd":3723.33},{"date":"2026-05-07","cop_per_usd":3706.44},{"date":"2026-05-08","cop_per_usd":3729.27},{"date":"2026-05-09","cop_per_usd":3747.1},{"date":"2026-05-12","cop_per_usd":3759},{"date":"2026-05-13","cop_per_usd":3775.07},{"date":"2026-05-14","cop_per_usd":3794.91},{"date":"2026-05-15","cop_per_usd":3784.7},{"date":"2026-05-16","cop_per_usd":3796.78},{"date":"2026-05-20","cop_per_usd":3796.87},{"date":"2026-05-21","cop_per_usd":3730.49},{"date":"2026-05-22","cop_per_usd":3701.37},{"date":"2026-05-23","cop_per_usd":3667.06},{"date":"2026-05-27","cop_per_usd":3644.47},{"date":"2026-05-28","cop_per_usd":3631.57},{"date":"2026-05-29","cop_per_usd":3646.58},{"date":"2026-05-30","cop_per_usd":3678.15},{"date":"2026-06-02","cop_per_usd":3560.24},{"date":"2026-06-03","cop_per_usd":3562},{"date":"2026-06-04","cop_per_usd":3572.85},{"date":"2026-06-05","cop_per_usd":3565.32},{"date":"2026-06-06","cop_per_usd":3588.09}]},"meta":{"timestamp":"2026-06-10T22:58:00.652Z","request_id":"2567698d-36ed-47d7-8fe6-55140c9abcdc"},"status":"ok","message":"History retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/convert":{"get":{"operationId":"get_v1_convert","tags":["Convert"],"summary":"Convert an amount between USD and COP at the latest TRM","description":"","parameters":[{"name":"from","in":"query","required":true,"description":"Source currency (USD or COP)","schema":{"type":"string"},"example":"USD"},{"name":"to","in":"query","required":true,"description":"Target currency (USD or COP)","schema":{"type":"string"},"example":"COP"},{"name":"amount","in":"query","required":false,"description":"Amount to convert","schema":{"type":"string"},"example":"100"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"COP","date":"2026-06-10","from":"USD","rate":3581.46,"amount":100,"result":358146,"source":"Banco de la República (Colombia TRM)","cop_per_usd":3581.46},"meta":{"timestamp":"2026-06-10T22:58:00.910Z","request_id":"d7169636-8ee7-4223-a7d9-fc66d42cfe01"},"status":"ok","message":"Conversion completed successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"date":"2026-06-10","source":"Colombia open data (datos.gov.co TRM dataset, live)","service":"colombiatrm-api","endpoints":{"GET /v1/date":"The TRM in effect on a given date (date=2026-06-09).","GET /v1/meta":"This document.","GET /v1/rate":"Latest TRM — pesos per dollar and the inverse.","GET /v1/convert":"Convert an amount between USD and COP at the latest TRM (from=USD, to=COP, amount=100).","GET /v1/history":"Daily TRM over a date range (from=2026-05-01, to=2026-06-09)."},"cop_per_usd":3581.46,"description":"Live official exchange-rate data for the Colombian peso (COP) — the Tasa Representativa del Mercado (TRM), Colombia's official daily USD/COP reference rate — from Colombia's government open-data portal. The rate endpoint returns the latest TRM (pesos per dollar and the inverse); the date endpoint returns the TRM in effect on any past date; the history endpoint returns the daily TRM over a date range; the convert endpoint converts an amount between USD and COP at the latest TRM. Live, no key, nothing stored. Distinct from the ECB, BCRA, BCRP and other central-bank feeds and from market mid-rates — this is Colombia's own legally-binding USD/COP TRM.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T22:58:01.310Z","request_id":"fc290dee-7b50-4a62-9cd6-c88030e2890d"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":500,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":680,"monthly_call_quota":22000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2050,"monthly_call_quota":115000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":5100,"monthly_call_quota":560000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/colombiatrm-api"}