Public API

The TMIYC Public API gives Pro and Whale subscribers programmatic read-only access to four data desks: news, whales, macro and markets. Use it to wire TMIYC into your own dashboards, trading bots, research notebooks or alerting pipelines.

Authentication

Every request to /api/v1/* must carry an X-API-Key header. Keys look like tmiyc_pk_<32 random chars> and are minted in the app at Settings → API. Each key is tied to your account and is shown to you exactly once at creation time — we only store a sha-256 hash server-side.

Rate limits

API keys are rate-limited to 60 requests per minute. Exceeding the limit returns HTTP 429 with a Retry-After header. Every successful response also carries the standard X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers so you can back off proactively.

Scopes

• read:news — real-time news feed
• read:whales — large on-chain transfers
• read:macro — macro-economic calendar
• read:markets — live market quotes

New keys receive all four read scopes by default. The API is strictly read-only — write endpoints are never exposed under /api/v1.

Quick start

# 1. Generate a key at /app/settings/api  → tmiyc_pk_...
# 2. Hit any endpoint:

curl -H "X-API-Key: $TMIYC_KEY" \
     https://tmiyc.trade/api/v1/news?limit=5

curl -H "X-API-Key: $TMIYC_KEY" \
     "https://tmiyc.trade/api/v1/whales?chain=ETH&min_usd=1000000&limit=20"

curl -H "X-API-Key: $TMIYC_KEY" \
     "https://tmiyc.trade/api/v1/macro?range=7d"

curl -H "X-API-Key: $TMIYC_KEY" \
     "https://tmiyc.trade/api/v1/markets?symbols=BTCUSDT,ETHUSDT,SOLUSDT"

Plans

API access requires an active Pro or Whale subscription. Free and Premium accounts can still browse this documentation, but key generation is gated. Pricing and plan details live on the pricing page.