创建预警

POST

https://api.cobre.co/v1/alerts

该 API 允许您为特定货币对创建 FX 汇率监控预警。创建预警时，只需提供货币对、条件类型（above、below 或 within_range）、汇率阈值及到期日期。API 将返回已创建的预警对象，其中包含唯一标识符和活跃状态。

请参阅 FX Alerts

常见错误

设置 max_rate 时未指定条件 above 或 within_range。

设置 min_rate 时未指定条件 below 或 within_range。

使用 usd/cop、cop/usd、usd/mxn、mxn/cop 以外的不支持货币对。

将 valid_until 设置为过去的日期，或未遵循 ISO 8601 格式。

在创建预警前忘记订阅 alerts.fx_rate.triggered Webhook。

在请求体中使用驼峰式字段名（请使用蛇形命名法：currency_pair、max_rate、min_rate）。

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201Success

application/json

Bodyapplication/json

🟠409

Request Example

Shell

JavaScript

Java

Swift

cURL

高于阈值预警区间范围预警低于阈值预警

curl --location 'https://api.cobre.co/v1/alerts' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "type": "fx_rate",
    "alias": "Above Example",
    "metadata": {
        "condition": "above",
        "currency_pair": "usd/cop",
        "max_rate": 3500
    },
    "valid_until": "2026-05-17T04:00:00Z"
}'

Response Example

201 - 高于阈值响应

{
    "id": "alt_7vH5YA5CI4",
    "creator": "usr_68TbxU1Uif",
    "type": "fx_rate",
    "alias": "Above Example",
    "active_status": true,
    "metadata": {
        "condition": "above",
        "currency_pair": "usd/cop",
        "max_rate": 3500
    },
    "valid_until": "2026-05-17T04:00:00Z",
    "created_at": "2026-04-17T04:36:58Z",
    "updated_at": "2026-04-17T04:36:58Z"
}

Modified at 2026-06-12 23:18:07

列出所有可用事件

获取所有预警

创建预警

常见错误#

Request

Responses

常见错误