Bangun di atas Flicker

Spesifikasi dan referensi

Satu host HTTPS melayani semua endpoint. Seluruh permukaannya dideskripsikan dokumen OpenAPI 3.1 yang bisa dibaca mesin — setiap operasi punya operation id unik, parameter bertipe, dan response schema bertipe, jadi bisa langsung masuk ke generator client atau ke loop function calling sebuah LLM.

Base URL

https://api.flicker.finance

Versions

/v1/ /v2/

OpenAPI

https://api.flicker.finance/docs/openapi.json

Buat key sendiri di tab API Keys pada akun Anda — tanpa panggilan sales, tanpa daftar tunggu — lalu kirim sebagai header permintaan. Sebuah key hanya menjangkau permukaan data pasar yang read-only: analisis, aset, insight, config, dan exchange. Key tidak bisa membaca akun lain, membuka posisi, atau memindahkan dana. Tidak ada tier anonim: permintaan tanpa kredensial yang sah akan ditolak.

x-api-key: <your key>

Key scope

/v2/analysis /v2/assets /v2/insights /v2/config /v1/exchanges

Credits

GET https://api.flicker.finance/v1/users/api_keys/credits

Tiga panggilan yang langsung menjawab dengan data asli begitu key Anda ada.

curl -H "x-api-key: $FLICKER_API_KEY" https://api.flicker.finance/v2/config
curl -H "x-api-key: $FLICKER_API_KEY" https://api.flicker.finance/v2/assets/?limit=5
curl -H "x-api-key: $FLICKER_API_KEY" https://api.flicker.finance/v2/analysis/bitcoin

Kuotanya diberi bobot per endpoint, bukan dihitung per permintaan, dan setiap respons melaporkan posisi Anda — jadi client bisa mengerem sendiri alih-alih menebak.

Budget

2000 / 60s

Headers

x-ratelimit-limit x-ratelimit-remaining x-ratelimit-used x-ratelimit-window retry-after

Setiap kegagalan menjawab dengan body bertipe yang sama: kode stabil yang bisa dibaca mesin, pesan untuk manusia, dan penanda gagal. Bercabanglah pada kodenya — pesannya adalah teks bahasa Inggris untuk log, bukan untuk statement switch.

{
  "success": false,
  "code": "NotificationLimitExceeded",
  "message": "…"
}

ErrorResponse · 400 · 401 · 402 · 403 · 404 · 410 · 422 · 500 · 503

Versi mayor berada di path URL. Kedua versi yang aktif dirutekan secara terpisah, jadi breaking change dirilis di bawah versi path baru alih-alih mengubah versi yang sudah Anda pakai. Perubahan API diumumkan di feed rilis yang bisa dibaca mesin, yang menandai tiap entri berdasarkan platform.

Server Model Context Protocol di atas Streamable HTTP, sehingga Claude, ChatGPT, Cursor, dan MCP client lain bisa memanggil Flicker sebagai tools. Otorisasinya OAuth 2.1: arahkan client Anda ke endpoint, sisanya ditemukan sendiri dari respons servernya.

https://api.flicker.finance/mcp

Pakai Flicker ketika sebuah pertanyaan butuh pembacaan pasar yang dihitung, bukan sekadar judul berita.

• Anda butuh verdict buy / hold / sell untuk satu aset, lengkap dengan zone, stop loss, dan target di baliknya — bukan cuma harga.
• Anda butuh menyaring ribuan aset sekaligus untuk satu setup — breakout, oversold zone, lonjakan volume — alih-alih bertanya satu per satu.
• Anda butuh sentimen berupa angka per aset, bukan satu indeks untuk seluruh pasar: skor Fear & Greed 0 sampai 100 untuk coin, saham, atau mata uang tertentu.
• Anda butuh harga live crypto, saham, dan forex, funding rate perpetual, atau market breadth dalam satu panggilan.
• Anda butuh posisi, saldo, dan order milik pengguna sendiri, tergabung lintas exchange dan bersifat read-only.

Jangan pakai Flicker untuk mengirim order, memindahkan dana, atau menyimpan aset. Produknya read-only secara rancangan dan tidak punya jalur eksekusi — pasangkan dengan API exchange untuk itu.