{
  "openapi": "3.1.0",
  "info": {
    "title": "Colombia TRM + TIBC + Captaciones + Tasas Activas + FIC + TemporalOps watch x402",
    "version": "0.6.10",
    "description": "Official Colombian TRM (USD/COP), TIBC, deposit/captación, active credit and FIC fund-return rates from Superintendencia Financiera, plus GitHub PR and App Store temporal watches. Prepaid x402 USDC on Base.",
    "contact": {
      "name": "TemporalOps",
      "url": "https://x402.lagaceta.net/.well-known/agent-card.json"
    },
    "x-guidance": "Pay with x402 USDC on Base. GET /trm ($0.005) official USD/COP. GET /tibc ($0.005) official TIBC. GET /captaciones ($0.005) official deposit rates. GET /tasas-activas ($0.005) official active credit rates. GET /fic ($0.005) official FIC fund returns. GET /v1/pr-watch ($0.01) GitHub PR/issue watch. GET /v1/appstore-watch ($0.01) App Store watch. Unpaid calls return HTTP 402 with PAYMENT-REQUIRED."
  },
  "servers": [
    {
      "url": "https://x402.lagaceta.net"
    }
  ],
  "security": [
    {
      "x402": []
    }
  ],
  "x-discovery": {
    "ownershipProofs": [
      "0x4945092C6586F078E0eD2130a53b0CDEe90c6796"
    ]
  },
  "components": {
    "securitySchemes": {
      "x402": {
        "type": "apiKey",
        "in": "header",
        "name": "PAYMENT-SIGNATURE",
        "description": "x402 v2 payment proof (base64 PaymentPayload). Unpaid requests receive HTTP 402 + PAYMENT-REQUIRED."
      }
    }
  },
  "paths": {
    "/trm": {
      "get": {
        "operationId": "getColombiaTrm",
        "summary": "Official Colombian TRM USD/COP",
        "description": "Superfinanciera daily TRM via datos.gov.co mcec-87by. mode=live for BanRep intradía.",
        "parameters": [
          {
            "name": "mode",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": ["official", "live"],
              "default": "official"
            }
          }
        ],
        "x-payment-info": {
          "protocols": ["x402"],
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.005"
          }
        },
        "responses": {
          "200": {
            "description": "Official TRM JSON"
          },
          "402": {
            "description": "Payment required (x402 v2 PAYMENT-REQUIRED)"
          }
        }
      }
    },
    "/tibc": {
      "get": {
        "operationId": "getColombiaTibc",
        "summary": "Official Colombian TIBC (interés bancario corriente)",
        "description": "Superfinanciera TIBC via datos.gov.co pare-7x5i. Current modalidades. Optional modalidad filter.",
        "parameters": [
          {
            "name": "modalidad",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "CONSUMO Y ORDINARIO"
            }
          }
        ],
        "x-payment-info": {
          "protocols": ["x402"],
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.005"
          }
        },
        "responses": {
          "200": {
            "description": "Official TIBC JSON"
          },
          "402": {
            "description": "Payment required (x402 v2 PAYMENT-REQUIRED)"
          }
        }
      }
    },
    "/captaciones": {
      "get": {
        "operationId": "getColombiaCaptaciones",
        "summary": "Official Colombian deposit/captación rates",
        "description": "Superfinanciera axk9-g2nh latest corte, ahorros persona natural. Optional entidad filter.",
        "parameters": [
          {
            "name": "entidad",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "Lulo"
            }
          }
        ],
        "x-payment-info": {
          "protocols": ["x402"],
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.005"
          }
        },
        "responses": {
          "200": {
            "description": "Official captaciones JSON"
          },
          "402": {
            "description": "Payment required (x402 v2 PAYMENT-REQUIRED)"
          }
        }
      }
    },
    "/tasas-activas": {
      "get": {
        "operationId": "getColombiaTasasActivas",
        "summary": "Official Colombian active credit rates",
        "description": "Superfinanciera qzsc-9esp latest corte, grouped by tipo/producto. Optional tipo, producto, entidad filters.",
        "parameters": [
          {
            "name": "tipo",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "Consumo"
            }
          },
          {
            "name": "producto",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "Libre inversión"
            }
          },
          {
            "name": "entidad",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "Bancolombia"
            }
          }
        ],
        "x-payment-info": {
          "protocols": ["x402"],
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.005"
          }
        },
        "responses": {
          "200": {
            "description": "Official tasas activas JSON"
          },
          "402": {
            "description": "Payment required (x402 v2 PAYMENT-REQUIRED)"
          }
        }
      }
    },
    "/fic": {
      "get": {
        "operationId": "getColombiaFic",
        "summary": "Official Colombian FIC fund returns",
        "description": "Superfinanciera qhpu-8ixx latest corte, top 40 by AUM. Optional entidad, fondo filters.",
        "parameters": [
          {
            "name": "entidad",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "Bancolombia"
            }
          },
          {
            "name": "fondo",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "FIDUCUENTA"
            }
          }
        ],
        "x-payment-info": {
          "protocols": ["x402"],
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.005"
          }
        },
        "responses": {
          "200": {
            "description": "Official FIC rentabilidades JSON"
          },
          "402": {
            "description": "Payment required (x402 v2 PAYMENT-REQUIRED)"
          }
        }
      }
    },
    "/weather": {
      "get": {
        "operationId": "getWeather",
        "summary": "Current weather",
        "x-payment-info": {
          "protocols": ["x402"],
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.003"
          }
        },
        "responses": {
          "200": {
            "description": "Weather JSON"
          },
          "402": {
            "description": "Payment required"
          }
        }
      }
    },
    "/scrape": {
      "get": {
        "operationId": "getScrape",
        "summary": "Public URL scrape",
        "x-payment-info": {
          "protocols": ["x402"],
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.008"
          }
        },
        "responses": {
          "200": {
            "description": "Extracted text"
          },
          "402": {
            "description": "Payment required"
          }
        }
      }
    },
    "/v1/pr-watch": {
      "get": {
        "operationId": "getPrWatch",
        "summary": "GitHub PR and issue watch",
        "description": "Temporal watch: new/changed PRs and issues on a public repo. LEY TEMPORAL pass.",
        "parameters": [
          {
            "name": "repo",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "unicentrocucuta/pe-x402-gateway"
            }
          }
        ],
        "x-payment-info": {
          "protocols": ["x402"],
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.01"
          }
        },
        "responses": {
          "200": {
            "description": "Watch delta JSON"
          },
          "402": {
            "description": "Payment required (x402 v2 PAYMENT-REQUIRED)"
          }
        }
      }
    },
    "/v1/appstore-watch": {
      "get": {
        "operationId": "getAppstoreWatch",
        "summary": "App Store version/price/reviews watch",
        "description": "Temporal watch: App Store listing version, price, and new reviews. LEY TEMPORAL pass.",
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "310633997"
            }
          }
        ],
        "x-payment-info": {
          "protocols": ["x402"],
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.01"
          }
        },
        "responses": {
          "200": {
            "description": "Watch delta JSON"
          },
          "402": {
            "description": "Payment required (x402 v2 PAYMENT-REQUIRED)"
          }
        }
      }
    }
  }
}
