Connect Colin Capital · Wealth Updates to your Agent

Add categoryto the news request to fetch only the corresponding category; if not passed, all categories are included. The returned entries' category also use the values in the table below.

1. 01
   Enable compression

   curl add --compressed, other clients open gzip or br. JSON compressed is only 1/4 to 1/8 of the original.

2. 02
   Bring ETag

   Save the ETag in the response, and bring it next time If-None-Match; returns 304 when the content has not changed, without passing the body.

3. 03
   Take it by rhythm

   News and hot spots at most once a minute; daily reportEvery day at 08:00 After that, take it once, and take it once after the weekly and monthly magazines are published; turn back the page and stop when you reach the existing one.

How often does the content change: new news comes in throughout the day, curated items change several to dozens of times a day, daily reportsEvery day at 08:00, weekly reports每Mon 10:00, monthly reportsOn the 1st of each month at 10:30(Beijing Time) each one issue.

# 第一次：保存响应头里的 ETag
curl --compressed -i 'https://colincapital.hk/en/news/api/v1/items?mode=selected&window=24h&limit=20'
# 之后最快每分钟一次，带上 ETag；返回 304 就是没变化
curl --compressed -i -H 'If-None-Match: <上次的 ETag>' 'https://colincapital.hk/en/news/api/v1/items?mode=selected&window=24h&limit=20'

When you need to page back, pass page.nextCursor it back as the cursor, stop when you reach an item you already have, and do not re-scan the last 7 days every time.

400

Invalid parameters: fix them according to the OpenAPI spec and the returned code; do not automatically switch to a broader query. If the cursor is invalid or outside the time window, invalid_cursor is returned; restart from the first page.

409

snapshot_required: the incremental update cannot be safely continued; fetch a full snapshot again.

429

Too many requests: wait according to Retry-After; do not retry concurrently.

5xx

Use exponential backoff and rely on the last successful result; public services do not guarantee an SLA.

Anonymous access does not mean every use case is permitted, seeTerms of use。