Pinnacle Advisoryv1.4.2 ProductionBVI Licensed VG1110
提交跨境風險評估
POST /v1/risk/evaluations — 提交跨境供應鏈與海外實體營運風險量化評估。
提交海外實體或跨境貿易鏈路的參數，啟動宏觀市場波動、合規性與匯率風險量化評分。
接口基本資訊
POST/v1/risk/evaluations
量化評估海外實體的宏觀法規、匯率波動及對手方信用風險。本接口即時計算並返回加權風險指數（0-100）。
請求參數規格
參數規格 (Parameters)
| 參數名稱 | 位置 | 類型 | 必填 | 說明 |
|---|---|---|---|---|
entity_jurisdiction | body | string | 必填 | 實體法定註冊法域，例如: BVI, Cayman, Singapore, Hong Kong示例: BVI |
business_model | body | string | 必填 | 主要營運模式: holding (純控股), ip_licensing (知識產權), trading (跨境貿易), consulting (諮詢服務)示例: holding |
annual_turnover_usd | body | number | 必填 | 年營業額估算 (USD)示例: 5000000 |
counterparty_regions | body | array | 必填 | 主要業務往來對手方法域代碼列表 (ISO 3166-1 alpha-2)示例: ["US", "SG", "GB"] |
risk_dimensions | body | array | 選填 | 指定評估維度: ["regulatory", "fx_volatility", "counterparty_credit"]示例: ["regulatory", "fx_volatility"] |
多語言發起調用示例
提交跨境風險評估 (POST /v1/risk/evaluations)
curl -X POST "https://api.pinnacle-advisory.vg/v1/risk/evaluations" \
-H "Authorization: Bearer sec_live_9a8b7c6d5e4f" \
-H "Content-Type: application/json" \
-d '{
"entity_jurisdiction": "BVI",
"business_model": "holding",
"annual_turnover_usd": 5000000,
"counterparty_regions": ["US", "SG", "GB"],
"risk_dimensions": ["regulatory", "fx_volatility"]
}'響應結構範例 (201 Created)
{
"status": "created",
"data": {
"evaluation_id": "eval_risk_20260929_8819",
"composite_risk_score": 26.5,
"risk_level": "LOW",
"dimension_scores": {
"regulatory_compliance": 18.0,
"fx_volatility": 32.5,
"counterparty_credit": 24.0
},
"recommendations": [
"Economic substance indicators for BVI pure equity holding are well within normal compliance range.",
"Consider dynamic FX hedging for USD/GBP exposure over 90 days."
]
}
}