Real-time market data, quantitative analysis, risk metrics, and multi-signal confluence scoring. Built for trading bots, algorithmic strategies, and fintech developers.
# Market data (crypto, forex, sentiment)
curl -H "X-API-Key: YOUR_KEY" \
https://api.tinkclaw.com/v1/market
# Quantitative analysis
curl -H "X-API-Key: YOUR_KEY" \
"https://api.tinkclaw.com/v1/quant?symbol=BTC"
# Confluence score (multi-signal 0-100)
curl -H "X-API-Key: YOUR_KEY" \
"https://api.tinkclaw.com/v1/confluence?symbol=BTC"import requests
BASE = "https://api.tinkclaw.com"
KEY = {"X-API-Key": "YOUR_KEY"}
# Market data
r = requests.get(f"{BASE}/v1/market", headers=KEY)
data = r.json()["data"]
print(data["crypto"][0]["price"]) # BTC price
# Confluence score — should your bot buy?
r = requests.get(f"{BASE}/v1/confluence", params={"symbol": "BTC"}, headers=KEY)
score = r.json()["data"]["score"] # 0-100
print(f"Confluence: {score}") # >70 = strong signalconst BASE = "https://api.tinkclaw.com";
const headers = { "X-API-Key": "YOUR_KEY" };
// Market data
const market = await fetch(`${BASE}/v1/market`, { headers });
const { data } = await market.json();
console.log(data.crypto[0].price); // BTC price
// Risk metrics for your portfolio
const risk = await fetch(`${BASE}/v1/quant/risk-metrics`, { headers });
const { data: metrics } = await risk.json();
console.log(metrics.sharpe_ratio); // risk-adjusted returnEvery response follows a standard envelope:
{
"success": true,
"data": { ... },
"meta": {
"timestamp": "2026-02-21T12:00:00Z",
"cached": false,
"cache_ttl": 1800,
"request_id": "req_m2b8f_k9x3p1"
}
}
Every response includes X-Request-Id, X-RateLimit-Remaining, and ETag headers.
Send If-None-Match with the ETag to get 304 (no body) when data hasn't changed.
| Header | Description |
|---|---|
| X-RateLimit-Limit | Your daily call limit |
| X-RateLimit-Remaining | Calls remaining today |
| X-RateLimit-Reset | Unix timestamp when limit resets (midnight UTC) |
| Retry-After | Seconds to wait (only on 429) |
Every plan includes full API access. No free tier — if your bot trades on our signals, we share in the value.
Errors return { "success": false, "error": { "code": "...", "message": "..." } }
| Code | Status | Description |
|---|---|---|
| MISSING_API_KEY | 401 | No X-API-Key header |
| INVALID_API_KEY | 401 | Key not found or revoked |
| EXPIRED_API_KEY | 401 | Key past expiration |
| SCOPE_DENIED | 403 | Key lacks required scope |
| RATE_LIMIT_EXCEEDED | 429 | Daily limit reached |
| ENDPOINT_NOT_FOUND | 404 | Unknown API endpoint |
| UPSTREAM_ERROR | 503 | Backend temporarily unavailable |
Paste your API key and test an endpoint live.
We'll review your application and send a key to your email.