Bitculator
Bitculator · Data API · v1

Bitculator Data API

73 endpoint 15 grup X-Quota-* di setiap panggilan http://localhost/api/v1

Semua endpoint berada di bawah /api/v1 dan memerlukan key Bearer dengan kemampuan data-api — buat satu di konsol developer Anda.

Panggilan pertama Anda:

curl https://bitculator.com/api/v1/prices/bitcoin \
  -H "Authorization: Bearer YOUR_API_KEY"

Respons berupa JSON. Harga, kurs, dan suplai berupa string desimal (float tidak dapat membawa presisi pasar); jumlah dan nilai analitik berupa angka. Setiap respons membawa kuota live Anda di header X-Quota-Limit / X-Quota-Used / X-Quota-Reset, dan galat selalu menggunakan envelope {"error": {"code", "message", "details"}}.

Data API memiliki kuota bulanan sendiri, terikat pada paket API Anda dan sepenuhnya terpisah dari widget embed Anda. Batas per_page berbasis paket (Free 100, Starter/Pro 250); melampaui batas mengembalikan 422 alih-alih membatasi.

Autentikasi

Untuk mengautentikasi permintaan, sertakan header Authorization: Bearer {YOUR_API_KEY} pada setiap permintaan.

Buat key Data API di konsol developer Anda — key hanya Bearer dan membawa kemampuan data-api. Simpan di sisi server; key tidak pernah dimaksudkan untuk disematkan di sisi klien.

Header Authorization
Buat key →
Bearer
bc_••••••••••••••••

Dikirim sebagai Authorization: Bearer {YOUR_API_KEY} pada setiap permintaan.

9 endpoint

Koin

Data pasar koin dan token berperingkat: daftar dipaginasi, detail satu koin, penggerak (gainers/losers), yang baru ditambahkan, trending, dan deret waktu per koin. Harga, marketcap, dan suplai berupa STRING desimal (float tidak dapat membawa presisi pasar); perubahan persentase, peringkat, dan jumlah berupa angka.

Daftar koin

Koin berperingkat dengan harga, filter, dan selektor, dipaginasi dengan envelope links + meta Laravel. Harga, marketcap, dan circulating_supply berupa string desimal; perubahan dan peringkat berupa angka.

GET
http://localhost/api/v1/coins
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

page
integer opsional
1

Nomor halaman (dimulai dari 1). Harus minimal 1.

per_page
integer opsional
50

Baris per halaman. Batas berbasis paket (Free 100, Starter/Pro 250); melampauinya mengembalikan 422 alih-alih membatasi. Harus minimal 1. Tidak boleh lebih dari 100.

type
string opsional
coin

Batasi ke satu tipe aset: coin atau token.

Salah satu dari: coin token

status
string opsional
active

Status listing: active, delisted, untracked, progressing, awaiting atau preparing. Default ke semua status publik.

Salah satu dari: active delisted untracked progressing awaiting preparing

search
string opsional
bitcoin

Pencocokan teks bebas pada nama atau simbol. Tidak boleh lebih dari 100 karakter.

min_price
number opsional
0.5

Hanya koin dengan harga pada atau di atas nilai USD ini. Harus minimal 0.

max_price
number opsional
100000

Hanya koin dengan harga pada atau di bawah nilai USD ini. Harus minimal 0.

min_marketcap
number opsional
1000000

Hanya koin dengan marketcap USD pada atau di atas nilai ini. Harus minimal 0.

max_marketcap
number opsional
5000000000000

Hanya koin dengan marketcap USD pada atau di bawah nilai ini. Harus minimal 0.

min_volume
number opsional
1000000

Hanya koin dengan volume USD 24 jam pada atau di atas nilai ini. Harus minimal 0.

max_volume
number opsional
100000000000

Hanya koin dengan volume USD 24 jam pada atau di bawah nilai ini. Harus minimal 0.

ids
string opsional
38,39

Filter ke id koin tertentu (CSV, hingga 100 selektor digabung dengan slugs/symbols). Tidak boleh lebih dari 1000 karakter.

slugs
string opsional
bitcoin,ethereum

Filter ke slug koin tertentu (CSV, hingga 100 selektor digabung). Tidak boleh lebih dari 2000 karakter.

symbols
string opsional
BTC,ETH

Filter ke simbol koin tertentu (CSV, tidak sensitif huruf besar/kecil, hingga 100 selektor digabung). Tidak boleh lebih dari 1000 karakter.

sort
string opsional
-marketcap

Field pengurutan dipisahkan koma; awali dengan - untuk menurun. Dapat diurutkan: marketcap, rank, price, volume_24h, change_24h, change_7d. Tidak boleh lebih dari 100 karakter.

interval
string opsional
24h

Jendela penggerak hanya untuk /coins/gainers dan /coins/losers: 24h atau 7d.

Salah satu dari: 24h 7d

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/coins?page=1&per_page=50&type=coin&status=active&search=bitcoin&min_price=0.5&max_price=100000&min_marketcap=1000000&max_marketcap=5000000000000&min_volume=1000000&max_volume=100000000000&ids=38%2C39&slugs=bitcoin%2Cethereum&symbols=BTC%2CETH&sort=-marketcap&interval=24h" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Koin yang baru ditambahkan

Listing terbaru — diurutkan berdasarkan status_updated_at (timestamp saat menjadi aktif; created_at adalah tanggal crawl, yang mendahului listing dalam jumlah sembarang). Bentuk baris dan envelope paginasi sama dengan List coins.

GET
http://localhost/api/v1/coins/recently-added
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

page
integer opsional
1

Nomor halaman (dimulai dari 1). Harus minimal 1.

per_page
integer opsional
50

Baris per halaman. Batas berbasis paket (Free 100, Starter/Pro 250); melampauinya mengembalikan 422 alih-alih membatasi. Harus minimal 1. Tidak boleh lebih dari 100.

type
string opsional
coin

Batasi ke satu tipe aset: coin atau token.

Salah satu dari: coin token

status
string opsional
active

Status listing: active, delisted, untracked, progressing, awaiting atau preparing. Default ke semua status publik.

Salah satu dari: active delisted untracked progressing awaiting preparing

search
string opsional
bitcoin

Pencocokan teks bebas pada nama atau simbol. Tidak boleh lebih dari 100 karakter.

min_price
number opsional
0.5

Hanya koin dengan harga pada atau di atas nilai USD ini. Harus minimal 0.

max_price
number opsional
100000

Hanya koin dengan harga pada atau di bawah nilai USD ini. Harus minimal 0.

min_marketcap
number opsional
1000000

Hanya koin dengan marketcap USD pada atau di atas nilai ini. Harus minimal 0.

max_marketcap
number opsional
5000000000000

Hanya koin dengan marketcap USD pada atau di bawah nilai ini. Harus minimal 0.

min_volume
number opsional
1000000

Hanya koin dengan volume USD 24 jam pada atau di atas nilai ini. Harus minimal 0.

max_volume
number opsional
100000000000

Hanya koin dengan volume USD 24 jam pada atau di bawah nilai ini. Harus minimal 0.

ids
string opsional
38,39

Filter ke id koin tertentu (CSV, hingga 100 selektor digabung dengan slugs/symbols). Tidak boleh lebih dari 1000 karakter.

slugs
string opsional
bitcoin,ethereum

Filter ke slug koin tertentu (CSV, hingga 100 selektor digabung). Tidak boleh lebih dari 2000 karakter.

symbols
string opsional
BTC,ETH

Filter ke simbol koin tertentu (CSV, tidak sensitif huruf besar/kecil, hingga 100 selektor digabung). Tidak boleh lebih dari 1000 karakter.

sort
string opsional
-marketcap

Field pengurutan dipisahkan koma; awali dengan - untuk menurun. Dapat diurutkan: marketcap, rank, price, volume_24h, change_24h, change_7d. Tidak boleh lebih dari 100 karakter.

interval
string opsional
24h

Jendela penggerak hanya untuk /coins/gainers dan /coins/losers: 24h atau 7d.

Salah satu dari: 24h 7d

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/coins/recently-added?page=1&per_page=50&type=coin&status=active&search=bitcoin&min_price=0.5&max_price=100000&min_marketcap=1000000&max_marketcap=5000000000000&min_volume=1000000&max_volume=100000000000&ids=38%2C39&slugs=bitcoin%2Cethereum&symbols=BTC%2CETH&sort=-marketcap&interval=24h" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Pemenang teratas

Penggerak positif terbesar selama jendela interval (bawaan 24h, atau 7d). Bentuk baris dan envelope paginasi sama dengan List coins.

GET
http://localhost/api/v1/coins/gainers
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

page
integer opsional
1

Nomor halaman (dimulai dari 1). Harus minimal 1.

per_page
integer opsional
50

Baris per halaman. Batas berbasis paket (Free 100, Starter/Pro 250); melampauinya mengembalikan 422 alih-alih membatasi. Harus minimal 1. Tidak boleh lebih dari 100.

type
string opsional
coin

Batasi ke satu tipe aset: coin atau token.

Salah satu dari: coin token

status
string opsional
active

Status listing: active, delisted, untracked, progressing, awaiting atau preparing. Default ke semua status publik.

Salah satu dari: active delisted untracked progressing awaiting preparing

search
string opsional
bitcoin

Pencocokan teks bebas pada nama atau simbol. Tidak boleh lebih dari 100 karakter.

min_price
number opsional
0.5

Hanya koin dengan harga pada atau di atas nilai USD ini. Harus minimal 0.

max_price
number opsional
100000

Hanya koin dengan harga pada atau di bawah nilai USD ini. Harus minimal 0.

min_marketcap
number opsional
1000000

Hanya koin dengan marketcap USD pada atau di atas nilai ini. Harus minimal 0.

max_marketcap
number opsional
5000000000000

Hanya koin dengan marketcap USD pada atau di bawah nilai ini. Harus minimal 0.

min_volume
number opsional
1000000

Hanya koin dengan volume USD 24 jam pada atau di atas nilai ini. Harus minimal 0.

max_volume
number opsional
100000000000

Hanya koin dengan volume USD 24 jam pada atau di bawah nilai ini. Harus minimal 0.

ids
string opsional
38,39

Filter ke id koin tertentu (CSV, hingga 100 selektor digabung dengan slugs/symbols). Tidak boleh lebih dari 1000 karakter.

slugs
string opsional
bitcoin,ethereum

Filter ke slug koin tertentu (CSV, hingga 100 selektor digabung). Tidak boleh lebih dari 2000 karakter.

symbols
string opsional
BTC,ETH

Filter ke simbol koin tertentu (CSV, tidak sensitif huruf besar/kecil, hingga 100 selektor digabung). Tidak boleh lebih dari 1000 karakter.

sort
string opsional
-marketcap

Field pengurutan dipisahkan koma; awali dengan - untuk menurun. Dapat diurutkan: marketcap, rank, price, volume_24h, change_24h, change_7d. Tidak boleh lebih dari 100 karakter.

interval
string opsional
24h

Jendela penggerak hanya untuk /coins/gainers dan /coins/losers: 24h atau 7d.

Salah satu dari: 24h 7d

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/coins/gainers?page=1&per_page=50&type=coin&status=active&search=bitcoin&min_price=0.5&max_price=100000&min_marketcap=1000000&max_marketcap=5000000000000&min_volume=1000000&max_volume=100000000000&ids=38%2C39&slugs=bitcoin%2Cethereum&symbols=BTC%2CETH&sort=-marketcap&interval=24h" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Pecundang teratas

Penggerak negatif terbesar selama jendela interval (bawaan 24h, atau 7d). Bentuk baris dan envelope paginasi sama dengan List coins.

GET
http://localhost/api/v1/coins/losers
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

page
integer opsional
1

Nomor halaman (dimulai dari 1). Harus minimal 1.

per_page
integer opsional
50

Baris per halaman. Batas berbasis paket (Free 100, Starter/Pro 250); melampauinya mengembalikan 422 alih-alih membatasi. Harus minimal 1. Tidak boleh lebih dari 100.

type
string opsional
coin

Batasi ke satu tipe aset: coin atau token.

Salah satu dari: coin token

status
string opsional
active

Status listing: active, delisted, untracked, progressing, awaiting atau preparing. Default ke semua status publik.

Salah satu dari: active delisted untracked progressing awaiting preparing

search
string opsional
bitcoin

Pencocokan teks bebas pada nama atau simbol. Tidak boleh lebih dari 100 karakter.

min_price
number opsional
0.5

Hanya koin dengan harga pada atau di atas nilai USD ini. Harus minimal 0.

max_price
number opsional
100000

Hanya koin dengan harga pada atau di bawah nilai USD ini. Harus minimal 0.

min_marketcap
number opsional
1000000

Hanya koin dengan marketcap USD pada atau di atas nilai ini. Harus minimal 0.

max_marketcap
number opsional
5000000000000

Hanya koin dengan marketcap USD pada atau di bawah nilai ini. Harus minimal 0.

min_volume
number opsional
1000000

Hanya koin dengan volume USD 24 jam pada atau di atas nilai ini. Harus minimal 0.

max_volume
number opsional
100000000000

Hanya koin dengan volume USD 24 jam pada atau di bawah nilai ini. Harus minimal 0.

ids
string opsional
38,39

Filter ke id koin tertentu (CSV, hingga 100 selektor digabung dengan slugs/symbols). Tidak boleh lebih dari 1000 karakter.

slugs
string opsional
bitcoin,ethereum

Filter ke slug koin tertentu (CSV, hingga 100 selektor digabung). Tidak boleh lebih dari 2000 karakter.

symbols
string opsional
BTC,ETH

Filter ke simbol koin tertentu (CSV, tidak sensitif huruf besar/kecil, hingga 100 selektor digabung). Tidak boleh lebih dari 1000 karakter.

sort
string opsional
-marketcap

Field pengurutan dipisahkan koma; awali dengan - untuk menurun. Dapat diurutkan: marketcap, rank, price, volume_24h, change_24h, change_7d. Tidak boleh lebih dari 100 karakter.

interval
string opsional
24h

Jendela penggerak hanya untuk /coins/gainers dan /coins/losers: 24h atau 7d.

Salah satu dari: 24h 7d

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/coins/losers?page=1&per_page=50&type=coin&status=active&search=bitcoin&min_price=0.5&max_price=100000&min_marketcap=1000000&max_marketcap=5000000000000&min_volume=1000000&max_volume=100000000000&ids=38%2C39&slugs=bitcoin%2Cethereum&symbols=BTC%2CETH&sort=-marketcap&interval=24h" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Ambil detail koin

Profil lengkap satu koin. Selain field daftar, ditambahkan: supply (circulating/total/max), OHLC today, all_time_high / all_time_low (harga, tanggal, dan percent_from harga saat ini), fully_diluted_valuation, counts pasar (exchanges/pairs/tickers/wallets), decimals, genesis_date, links resmi (daftar url bertipe), contracts token, dan description HTML yang dilokalkan (fallback ke bahasa Inggris jika locale yang diminta tidak ada). Semua field harga/suplai berupa string desimal.

GET
http://localhost/api/v1/coins/{slug}
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
bitcoin

Slug koin.

Parameter query

locale
string opsional
en

Bahasa konten untuk deskripsi (fallback ke bahasa Inggris).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/coins/bitcoin?locale=en" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Riwayat candle

Deret waktu OHLC + volume + marketcap per koin. Pilih interval: minutely, half-hourly, hourly atau daily. Retensi adalah properti tetap dari pipeline rollup — minutely 8 hari, half-hourly 3 bulan, hourly 6 bulan, daily selamanya; permintaan di luar jendela mengembalikan yang ada. Ketika limit diatur, Anda mendapatkan N baris TERBARU dalam jendela, dipancarkan dari yang terlama dulu. Harga berupa string desimal.

GET
http://localhost/api/v1/coins/{slug}/history
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
bitcoin

Slug koin.

Parameter query

interval
string opsional
daily

minutely, half-hourly, hourly atau daily (bawaan daily).

start
string opsional
2026-06-01

Batas bawah tanggal/waktu ISO.

end
string opsional
2026-06-30

Batas atas tanggal/waktu ISO (nilai hanya-tanggal berarti hingga akhir hari itu).

limit
integer opsional
30

Baris maksimum (1–2000, bawaan 1000).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/coins/bitcoin/history?interval=daily&start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Riwayat marketcap

Rollup per koin yang sama seperti Candle history, diproyeksikan hanya ke {time, marketcap}. Pilihan interval dan jendela retensi yang sama (minutely 8 hari, half-hourly 3 bulan, hourly 6 bulan, daily selamanya), N-terbaru ketika limit diatur.

GET
http://localhost/api/v1/coins/{slug}/marketcap-history
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
bitcoin

Slug koin.

Parameter query

interval
string opsional
daily

minutely, half-hourly, hourly atau daily (bawaan daily).

start
string opsional
2026-06-01

Batas bawah tanggal/waktu ISO.

end
string opsional
2026-06-30

Batas atas tanggal/waktu ISO.

limit
integer opsional
30

Baris maksimum (1–2000, bawaan 1000).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/coins/bitcoin/marketcap-history?interval=daily&start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Sparkline koin

Seri harga ringkas untuk koin selama period yang dipilih, untuk menggambar sparkline.

GET
http://localhost/api/v1/coins/{slug}/sparkline
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
bitcoin

Slug koin.

Parameter query

period
string opsional
7d

24h, 7d, 30d, 60d, 90d, 180d atau 365d (bawaan 7d).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/coins/bitcoin/sparkline?period=7d" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
3 endpoint

Harga

Jalur-cepat harga yang ringan — harga saat ini, marketcap, volume 24 jam, dan perubahan terkini untuk sekumpulan koin yang diminta. /prices memerlukan selektor (ids, slugs atau symbols); /prices/{slug} menargetkan satu koin. Opsional convert ke mata uang fiat (harga kripto diperbarui ~setiap menit, FX fiat ~dua kali sehari). Harga dan marketcap berupa string desimal.

Ambil harga

Harga untuk sekumpulan koin yang diminta. Berikan setidaknya satu selektor — ids, slugs atau symbols (hingga 100 digabung). meta.currency menggemakan target konversi (USD kecuali convert diatur).

GET
http://localhost/api/v1/prices
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

ids
string opsional
38,39

ID koin untuk penetapan harga (CSV). Setidaknya salah satu dari ids, slugs, atau symbols wajib diisi; ketiga daftar dibatasi total 100 selektor. Field ini wajib diisi ketika slugs dan symbols tidak ada. Tidak boleh lebih dari 1000 karakter.

slugs
string opsional
bitcoin,ethereum

Slug koin untuk penetapan harga (CSV). Setidaknya salah satu dari ids, slugs, atau symbols wajib diisi. Field ini wajib diisi ketika ids dan symbols tidak ada. Tidak boleh lebih dari 2000 karakter.

symbols
string opsional
BTC,ETH

Simbol koin untuk penetapan harga (CSV, tidak sensitif huruf besar/kecil). Setidaknya salah satu dari ids, slugs, atau symbols wajib diisi. Field ini wajib diisi ketika ids dan slugs tidak ada. Tidak boleh lebih dari 1000 karakter.

convert
string opsional
EUR

Konversi harga/marketcap ke mata uang fiat aktif berdasarkan simbol (bawaan USD). Kurs FX diperbarui ~dua kali sehari.

Salah satu dari: USD EUR JPY BGN CZK DKK GBP HUF PLN RON SEK CHF ISK NOK HRK RUB TRY AUD BRL CAD CNY HKD IDR ILS INR KRW MXN MYR NZD PHP SGD THB ZAR ARS DZD MAD TWD

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/prices?ids=38%2C39&slugs=bitcoin%2Cethereum&symbols=BTC%2CETH&convert=EUR" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Ambil harga koin

Snapshot harga satu koin. Opsional convert ke mata uang fiat aktif berdasarkan simbol (bawaan USD).

GET
http://localhost/api/v1/prices/{slug}
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
bitcoin

Slug koin.

Parameter query

convert
string opsional
EUR

Simbol mata uang fiat aktif untuk penetapan harga (bawaan USD).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/prices/bitcoin?convert=EUR" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Harga historis

Harga USD koin pada tanggal tertentu, dibaca dari riwayat harian (hari persis, fallback ±3 hari — resolver yang sama yang digunakan portofolio). Hanya kripto: baris fiat tidak memiliki riwayat harian.

GET
http://localhost/api/v1/historical-price
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

slug
string wajib
bitcoin

Identifier slug koin.

date
string wajib
2021-04-14

date Tanggal pencarian (setelah 2008-12-31, tidak di masa depan).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/historical-price?slug=bitcoin&date=2021-04-14" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
5 endpoint

Pasar

Ticker (pasar per bursa) dan pair (pasar teragregasi lintas venue), plus pasar sebuah koin dan simbol trading mentah per bursa. Semuanya adalah data snapshot — tidak ada riwayat per ticker/pair. Volume USD berupa angka; harga berupa string desimal.

Pasar koin

Semua pasar untuk sebuah koin — ticker yang pair-nya memiliki koin sebagai base ATAU quote. Bentuk baris dan filter sama dengan List tickers.

GET
http://localhost/api/v1/coins/{slug}/markets
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
bitcoin

Slug koin.

Parameter query

page
integer opsional
1

Nomor halaman (dimulai dari 1). Harus minimal 1.

per_page
integer opsional
50

Baris per halaman. Batas berbasis paket (Free 100, Starter/Pro 250); melampauinya mengembalikan 422 alih-alih membatasi. Harus minimal 1. Tidak boleh lebih dari 100.

exchange
string opsional
binance-exchange

Batasi ke satu bursa berdasarkan slug (kosongkan pada daftar per bursa, yang sudah dilingkup). Harus cocok dengan regex /^[a-z0-9-]{1,120}$/.

pair
integer opsional
1

Batasi ke satu pair berdasarkan id. Harus minimal 1.

instrument
string opsional
spot

Tipe instrumen: future, option, swap, spot atau margin (bentuk jamak diterima).

Salah satu dari: future option swap spot margin

search
string opsional
BTC

Pencocokan teks bebas pada simbol ticker. Tidak boleh lebih dari 50 karakter.

min_volume
number opsional
1000000

Hanya ticker dengan volume USD 24 jam pada atau di atas nilai ini. Harus minimal 0.

max_volume
number opsional
100000000000

Hanya ticker dengan volume USD 24 jam pada atau di bawah nilai ini. Harus minimal 0.

min_change
number opsional
-50

Hanya ticker dengan perubahan persentase 24 jam pada atau di atas nilai ini.

max_change
number opsional
50

Hanya ticker dengan perubahan persentase 24 jam pada atau di bawah nilai ini.

sort
string opsional
-volume_usd

Satu field pengurutan (awali dengan - untuk menurun). Dapat diurutkan: volume_usd, change_24h, price_usd, updated. Default -volume_usd. Tidak boleh lebih dari 100 karakter.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/coins/bitcoin/markets?page=1&per_page=50&exchange=binance-exchange&pair=1&instrument=spot&search=BTC&min_volume=1000000&max_volume=100000000000&min_change=-50&max_change=50&sort=-volume_usd" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Simbol trading koin

Simbol trading mentah per bursa koin — data referensi yang terisi jarang (cakupan bersifat upaya-terbaik).

GET
http://localhost/api/v1/coins/{slug}/symbols
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
bitcoin

Slug koin.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/coins/bitcoin/symbols" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Daftar ticker

Pasar per bursa individual (ticker), dipaginasi. Filter berdasarkan exchange, pair, instrument, dan rentang volume/perubahan. Volume USD berupa angka; harga berupa string desimal.

GET
http://localhost/api/v1/tickers
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

page
integer opsional
1

Nomor halaman (dimulai dari 1). Harus minimal 1.

per_page
integer opsional
50

Baris per halaman. Batas berbasis paket (Free 100, Starter/Pro 250); melampauinya mengembalikan 422 alih-alih membatasi. Harus minimal 1. Tidak boleh lebih dari 100.

exchange
string opsional
binance-exchange

Batasi ke satu bursa berdasarkan slug (kosongkan pada daftar per bursa, yang sudah dilingkup). Harus cocok dengan regex /^[a-z0-9-]{1,120}$/.

pair
integer opsional
1

Batasi ke satu pair berdasarkan id. Harus minimal 1.

instrument
string opsional
spot

Tipe instrumen: future, option, swap, spot atau margin (bentuk jamak diterima).

Salah satu dari: future option swap spot margin

search
string opsional
BTC

Pencocokan teks bebas pada simbol ticker. Tidak boleh lebih dari 50 karakter.

min_volume
number opsional
1000000

Hanya ticker dengan volume USD 24 jam pada atau di atas nilai ini. Harus minimal 0.

max_volume
number opsional
100000000000

Hanya ticker dengan volume USD 24 jam pada atau di bawah nilai ini. Harus minimal 0.

min_change
number opsional
-50

Hanya ticker dengan perubahan persentase 24 jam pada atau di atas nilai ini.

max_change
number opsional
50

Hanya ticker dengan perubahan persentase 24 jam pada atau di bawah nilai ini.

sort
string opsional
-volume_usd

Satu field pengurutan (awali dengan - untuk menurun). Dapat diurutkan: volume_usd, change_24h, price_usd, updated. Default -volume_usd. Tidak boleh lebih dari 100 karakter.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/tickers?page=1&per_page=50&exchange=binance-exchange&pair=1&instrument=spot&search=BTC&min_volume=1000000&max_volume=100000000000&min_change=-50&max_change=50&sort=-volume_usd" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Daftar pair

Pair trading teragregasi lintas venue, diperingkat berdasarkan volume USD 24 jam. Filter berdasarkan slug koin (base atau quote) dan rentang volume.

GET
http://localhost/api/v1/pairs
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

page
integer opsional
1

Nomor halaman (dimulai dari 1). Harus minimal 1.

per_page
integer opsional
50

Baris per halaman. Batas berbasis paket (Free 100, Starter/Pro 250); melampauinya mengembalikan 422 alih-alih membatasi. Harus minimal 1. Tidak boleh lebih dari 100.

search
string opsional
BTC

Pencocokan teks bebas pada simbol pair. Tidak boleh lebih dari 50 karakter.

coin
string opsional
bitcoin

Batasi ke pair di mana slug koin ini adalah aset base atau quote. Harus cocok dengan regex /^[a-z0-9-]{1,120}$/.

min_volume
number opsional
1000000

Hanya pair dengan volume USD 24 jam pada atau di atas nilai ini. Harus minimal 0.

max_volume
number opsional
100000000000

Hanya pair dengan volume USD 24 jam pada atau di bawah nilai ini. Harus minimal 0.

sort
string opsional
-volume_usd

Field pengurutan: volume_usd atau updated (awali dengan - untuk menurun). Default -volume_usd.

Salah satu dari: volume_usd -volume_usd updated -updated

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/pairs?page=1&per_page=50&search=BTC&coin=bitcoin&min_volume=1000000&max_volume=100000000000&sort=-volume_usd" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Ambil detail pair

Satu pair plus setiap ticker bursa yang mendaftarkannya, diurutkan berdasarkan volume.

GET
http://localhost/api/v1/pairs/{id}
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

id
integer wajib
1

Id pair.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/pairs/1" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
7 endpoint

Bursa

Peringkat bursa, detail, trust score, deret waktu, dan daftar pasar/koin per bursa. Volume dalam USD. Tidak ada kolom CEX/DEX — type diturunkan dari taksonomi bursa, jadi bisa "cex", "dex", atau null.

Daftar bursa

Bursa berperingkat dengan volume 24 jam, dominasi, jumlah pair/aset, dan perubahan terkini. Dipaginasi dengan envelope links + meta Laravel.

GET
http://localhost/api/v1/exchanges
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

page
integer opsional
1

Nomor halaman (dimulai dari 1). Harus minimal 1.

per_page
integer opsional
50

Baris per halaman. Batas berbasis paket (Free 100, Starter/Pro 250); melampauinya mengembalikan 422 alih-alih membatasi. Harus minimal 1. Tidak boleh lebih dari 100.

type
string opsional
cex

Batasi ke tipe venue: cex atau dex (diselesaikan melalui taksonomi bursa).

Salah satu dari: cex dex

search
string opsional
binance

Pencocokan teks bebas pada nama bursa. Tidak boleh lebih dari 100 karakter.

min_pairs
integer opsional
100

Hanya bursa yang mendaftarkan setidaknya sebanyak ini pair. Harus minimal 0.

max_pairs
integer opsional
2000

Hanya bursa yang mendaftarkan paling banyak sebanyak ini pair. Harus minimal 0.

min_assets
integer opsional
50

Hanya bursa yang mendaftarkan setidaknya sebanyak ini aset. Harus minimal 0.

max_assets
integer opsional
1000

Hanya bursa yang mendaftarkan paling banyak sebanyak ini aset. Harus minimal 0.

min_volume
number opsional
1000000

Hanya bursa dengan volume USD 24 jam pada atau di atas nilai ini. Harus minimal 0.

max_volume
number opsional
100000000000

Hanya bursa dengan volume USD 24 jam pada atau di bawah nilai ini. Harus minimal 0.

ids
string opsional
1,12

Filter ke id bursa tertentu (CSV, hingga 100). Tidak boleh lebih dari 1000 karakter.

slugs
string opsional
binance-exchange,gateio

Filter ke slug bursa tertentu (CSV, hingga 100). Tidak boleh lebih dari 2000 karakter.

sort
string opsional
-volume

Field pengurutan dipisahkan koma; awali dengan - untuk menurun. Dapat diurutkan: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets. Tidak boleh lebih dari 100 karakter.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/exchanges?page=1&per_page=50&type=cex&search=binance&min_pairs=100&max_pairs=2000&min_assets=50&max_assets=1000&min_volume=1000000&max_volume=100000000000&ids=1%2C12&slugs=binance-exchange%2Cgateio&sort=-volume" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Ambil detail bursa

Profil lengkap satu bursa: peringkat, volume/dominasi, jumlah pair dan aset, tanggal established, location, website referral, dan type turunan (cex/dex/null).

GET
http://localhost/api/v1/exchanges/{slug}
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
binance-exchange

Slug bursa.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/exchanges/binance-exchange" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Ambil trust score bursa

Trust score agregat 0–10 plus breakdown 13 faktornya (rank, volume, age, volume_trend, stability, rank_stability, ticker_health, pairs, community, assets, dominance, market_breadth, transparency). Dihitung per bursa dan di-cache 24 jam.

GET
http://localhost/api/v1/exchanges/{slug}/trust-score
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
binance-exchange

Slug bursa.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/exchanges/binance-exchange/trust-score" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Riwayat bursa

Deret waktu volume / dominasi / pair / aset (rollup bursa tidak membawa OHLC). Pilih interval: minutely, hourly atau daily. Retensi adalah properti tetap dari pipeline rollup — minutely 8 hari, hourly 6 bulan, daily selamanya; ketika limit diatur, Anda mendapatkan N baris terbaru dalam jendela, dari yang terlama dulu.

GET
http://localhost/api/v1/exchanges/{slug}/history
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
binance-exchange

Slug bursa.

Parameter query

interval
string opsional
daily

minutely, hourly atau daily (bawaan daily).

start
string opsional
2026-06-01

Batas bawah tanggal/waktu ISO.

end
string opsional
2026-06-30

Batas atas tanggal/waktu ISO (nilai hanya-tanggal berarti hingga akhir hari itu).

limit
integer opsional
30

Baris maksimum (1–2000, bawaan 1000).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/exchanges/binance-exchange/history?interval=daily&start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Sparkline bursa

Seri sparkline volume bursa untuk suatu periode (bawaan 7d) — seri yang sama yang dirender baris bursa di web.

GET
http://localhost/api/v1/exchanges/{slug}/sparkline
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
binance-exchange

Slug bursa.

Parameter query

period
string opsional
7d

Salah satu dari 24h, 7d (bawaan), 30d, 60d, 90d, 180d, 365d.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/exchanges/binance-exchange/sparkline?period=7d" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Pasar bursa

Daftar ticker bursa (pasarnya), dipaginasi. Sudah dilingkup ke bursa — jangan berikan parameter exchange di sini.

GET
http://localhost/api/v1/exchanges/{slug}/tickers
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
binance-exchange

Slug bursa.

Parameter query

page
integer opsional
1

Nomor halaman (dimulai dari 1). Harus minimal 1.

per_page
integer opsional
50

Baris per halaman. Batas berbasis paket (Free 100, Starter/Pro 250); melampauinya mengembalikan 422 alih-alih membatasi. Harus minimal 1. Tidak boleh lebih dari 100.

exchange
string opsional
binance-exchange

Batasi ke satu bursa berdasarkan slug (kosongkan pada daftar per bursa, yang sudah dilingkup). Harus cocok dengan regex /^[a-z0-9-]{1,120}$/.

pair
integer opsional
1

Batasi ke satu pair berdasarkan id. Harus minimal 1.

instrument
string opsional
spot

Tipe instrumen: future, option, swap, spot atau margin (bentuk jamak diterima).

Salah satu dari: future option swap spot margin

search
string opsional
BTC

Pencocokan teks bebas pada simbol ticker. Tidak boleh lebih dari 50 karakter.

min_volume
number opsional
1000000

Hanya ticker dengan volume USD 24 jam pada atau di atas nilai ini. Harus minimal 0.

max_volume
number opsional
100000000000

Hanya ticker dengan volume USD 24 jam pada atau di bawah nilai ini. Harus minimal 0.

min_change
number opsional
-50

Hanya ticker dengan perubahan persentase 24 jam pada atau di atas nilai ini.

max_change
number opsional
50

Hanya ticker dengan perubahan persentase 24 jam pada atau di bawah nilai ini.

sort
string opsional
-volume_usd

Satu field pengurutan (awali dengan - untuk menurun). Dapat diurutkan: volume_usd, change_24h, price_usd, updated. Default -volume_usd. Tidak boleh lebih dari 100 karakter.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/exchanges/binance-exchange/tickers?page=1&per_page=50&exchange=binance-exchange&pair=1&instrument=spot&search=BTC&min_volume=1000000&max_volume=100000000000&min_change=-50&max_change=50&sort=-volume_usd" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Koin bursa

Koin yang terdaftar di bursa, dikembalikan dalam bentuk sama seperti List coins dan menerima filter/pengurutan yang sama.

GET
http://localhost/api/v1/exchanges/{slug}/assets
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
binance-exchange

Slug bursa.

Parameter query

page
integer opsional
1

Nomor halaman (dimulai dari 1). Harus minimal 1.

per_page
integer opsional
50

Baris per halaman. Batas berbasis paket (Free 100, Starter/Pro 250); melampauinya mengembalikan 422 alih-alih membatasi. Harus minimal 1. Tidak boleh lebih dari 100.

type
string opsional
coin

Batasi ke satu tipe aset: coin atau token.

Salah satu dari: coin token

status
string opsional
active

Status listing: active, delisted, untracked, progressing, awaiting atau preparing. Default ke semua status publik.

Salah satu dari: active delisted untracked progressing awaiting preparing

search
string opsional
bitcoin

Pencocokan teks bebas pada nama atau simbol. Tidak boleh lebih dari 100 karakter.

min_price
number opsional
0.5

Hanya koin dengan harga pada atau di atas nilai USD ini. Harus minimal 0.

max_price
number opsional
100000

Hanya koin dengan harga pada atau di bawah nilai USD ini. Harus minimal 0.

min_marketcap
number opsional
1000000

Hanya koin dengan marketcap USD pada atau di atas nilai ini. Harus minimal 0.

max_marketcap
number opsional
5000000000000

Hanya koin dengan marketcap USD pada atau di bawah nilai ini. Harus minimal 0.

min_volume
number opsional
1000000

Hanya koin dengan volume USD 24 jam pada atau di atas nilai ini. Harus minimal 0.

max_volume
number opsional
100000000000

Hanya koin dengan volume USD 24 jam pada atau di bawah nilai ini. Harus minimal 0.

ids
string opsional
38,39

Filter ke id koin tertentu (CSV, hingga 100 selektor digabung dengan slugs/symbols). Tidak boleh lebih dari 1000 karakter.

slugs
string opsional
bitcoin,ethereum

Filter ke slug koin tertentu (CSV, hingga 100 selektor digabung). Tidak boleh lebih dari 2000 karakter.

symbols
string opsional
BTC,ETH

Filter ke simbol koin tertentu (CSV, tidak sensitif huruf besar/kecil, hingga 100 selektor digabung). Tidak boleh lebih dari 1000 karakter.

sort
string opsional
-marketcap

Field pengurutan dipisahkan koma; awali dengan - untuk menurun. Dapat diurutkan: marketcap, rank, price, volume_24h, change_24h, change_7d. Tidak boleh lebih dari 100 karakter.

interval
string opsional
24h

Jendela penggerak hanya untuk /coins/gainers dan /coins/losers: 24h atau 7d.

Salah satu dari: 24h 7d

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/exchanges/binance-exchange/assets?page=1&per_page=50&type=coin&status=active&search=bitcoin&min_price=0.5&max_price=100000&min_marketcap=1000000&max_marketcap=5000000000000&min_volume=1000000&max_volume=100000000000&ids=38%2C39&slugs=bitcoin%2Cethereum&symbols=BTC%2CETH&sort=-marketcap&interval=24h" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
5 endpoint

Dompet

Ulasan dompet kripto — score ulasan, jumlah aset yang didukung, jumlah pro/kontra, model harga dan tanggal rilis, plus taksonomi tag yang dikelompokkan pada respons detail/perbandingan. meta.top_score adalah skor tertinggi di seluruh dompet (gunakan untuk menormalkan skor ke rentang 0–1).

Daftar dompet

Dompet yang diulas dengan skor, jumlah aset, jumlah pro/kontra, model harga, status dan tanggal rilis. Dipaginasi dengan envelope links + meta Laravel, plus meta.top_score.

GET
http://localhost/api/v1/wallets
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

page
integer opsional
1

Nomor halaman (dimulai dari 1). Harus minimal 1.

per_page
integer opsional
50

Baris per halaman. Batas berbasis paket (Free 100, Starter/Pro 250); melampauinya mengembalikan 422 alih-alih membatasi. Harus minimal 1. Tidak boleh lebih dari 100.

search
string opsional
ledger

Pencocokan teks bebas pada nama dompet. Tidak boleh lebih dari 100 karakter.

min_score
integer opsional
50

Hanya dompet dengan skor ulasan pada atau di atas nilai ini. Harus minimal 0.

max_score
integer opsional
214

Hanya dompet dengan skor ulasan pada atau di bawah nilai ini. Harus minimal 0.

tags
string opsional
12,34

Filter berdasarkan taksonomi tag: id grup kategori dipisahkan koma (id yang sama yang dikirim filter faset web). Tidak boleh lebih dari 1000 karakter.

ids
string opsional
175,317

Filter ke id dompet tertentu (CSV, hingga 100). Tidak boleh lebih dari 1000 karakter.

slugs
string opsional
frostsnap,coin98-fusion-card

Filter ke slug dompet tertentu (CSV, hingga 100). Tidak boleh lebih dari 2000 karakter.

sort
string opsional
-score

Field pengurutan dipisahkan koma; awali dengan - untuk menurun. Dapat diurutkan: score, released_at, assets, pros, cons. Tidak boleh lebih dari 100 karakter.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/wallets?page=1&per_page=50&search=ledger&min_score=50&max_score=214&tags=12%2C34&ids=175%2C317&slugs=frostsnap%2Ccoin98-fusion-card&sort=-score" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Linimasa rilis dompet

Daftar dompet dipatok ke released_at menurun (dompet tanpa tanggal di akhir). Bentuk baris dan envelope paginasi sama dengan List wallets.

GET
http://localhost/api/v1/wallets/timeline
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

page
integer opsional
1

Nomor halaman (dimulai dari 1). Harus minimal 1.

per_page
integer opsional
50

Baris per halaman. Batas berbasis paket (Free 100, Starter/Pro 250); melampauinya mengembalikan 422 alih-alih membatasi. Harus minimal 1. Tidak boleh lebih dari 100.

search
string opsional
ledger

Pencocokan teks bebas pada nama dompet. Tidak boleh lebih dari 100 karakter.

min_score
integer opsional
50

Hanya dompet dengan skor ulasan pada atau di atas nilai ini. Harus minimal 0.

max_score
integer opsional
214

Hanya dompet dengan skor ulasan pada atau di bawah nilai ini. Harus minimal 0.

tags
string opsional
12,34

Filter berdasarkan taksonomi tag: id grup kategori dipisahkan koma (id yang sama yang dikirim filter faset web). Tidak boleh lebih dari 1000 karakter.

ids
string opsional
175,317

Filter ke id dompet tertentu (CSV, hingga 100). Tidak boleh lebih dari 1000 karakter.

slugs
string opsional
frostsnap,coin98-fusion-card

Filter ke slug dompet tertentu (CSV, hingga 100). Tidak boleh lebih dari 2000 karakter.

sort
string opsional
-score

Field pengurutan dipisahkan koma; awali dengan - untuk menurun. Dapat diurutkan: score, released_at, assets, pros, cons. Tidak boleh lebih dari 100 karakter.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/wallets/timeline?page=1&per_page=50&search=ledger&min_score=50&max_score=214&tags=12%2C34&ids=175%2C317&slugs=frostsnap%2Ccoin98-fusion-card&sort=-score" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Bandingkan dompet

Perbandingan berdampingan 2–4 dompet dengan taksonomi tag berkelompok lengkapnya. data[] mempertahankan urutan slug yang diminta sehingga konsumen dapat merender kolom secara posisional.

GET
http://localhost/api/v1/wallets/compare
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

slugs
string wajib
frostsnap,coin98-fusion-card

2–4 slug dompet berbeda, dipisahkan koma.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/wallets/compare?slugs=frostsnap%2Ccoin98-fusion-card" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Ambil detail dompet

Profil lengkap satu dompet termasuk taksonomi tag yang dikelompokkan: categories adalah daftar {group, tags[]} di mana setiap tag memiliki slug, nama, dan nilai opsional. meta.top_score adalah skor tertinggi di seluruh dompet.

GET
http://localhost/api/v1/wallets/{slug}
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
frostsnap

Slug dompet.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/wallets/frostsnap" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Koin yang didukung dompet

Koin yang didukung dompet, dikembalikan dalam bentuk sama seperti List coins dan menerima filter/pengurutan yang sama.

GET
http://localhost/api/v1/wallets/{slug}/assets
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
frostsnap

Slug dompet.

Parameter query

page
integer opsional
1

Nomor halaman (dimulai dari 1). Harus minimal 1.

per_page
integer opsional
50

Baris per halaman. Batas berbasis paket (Free 100, Starter/Pro 250); melampauinya mengembalikan 422 alih-alih membatasi. Harus minimal 1. Tidak boleh lebih dari 100.

type
string opsional
coin

Batasi ke satu tipe aset: coin atau token.

Salah satu dari: coin token

status
string opsional
active

Status listing: active, delisted, untracked, progressing, awaiting atau preparing. Default ke semua status publik.

Salah satu dari: active delisted untracked progressing awaiting preparing

search
string opsional
bitcoin

Pencocokan teks bebas pada nama atau simbol. Tidak boleh lebih dari 100 karakter.

min_price
number opsional
0.5

Hanya koin dengan harga pada atau di atas nilai USD ini. Harus minimal 0.

max_price
number opsional
100000

Hanya koin dengan harga pada atau di bawah nilai USD ini. Harus minimal 0.

min_marketcap
number opsional
1000000

Hanya koin dengan marketcap USD pada atau di atas nilai ini. Harus minimal 0.

max_marketcap
number opsional
5000000000000

Hanya koin dengan marketcap USD pada atau di bawah nilai ini. Harus minimal 0.

min_volume
number opsional
1000000

Hanya koin dengan volume USD 24 jam pada atau di atas nilai ini. Harus minimal 0.

max_volume
number opsional
100000000000

Hanya koin dengan volume USD 24 jam pada atau di bawah nilai ini. Harus minimal 0.

ids
string opsional
38,39

Filter ke id koin tertentu (CSV, hingga 100 selektor digabung dengan slugs/symbols). Tidak boleh lebih dari 1000 karakter.

slugs
string opsional
bitcoin,ethereum

Filter ke slug koin tertentu (CSV, hingga 100 selektor digabung). Tidak boleh lebih dari 2000 karakter.

symbols
string opsional
BTC,ETH

Filter ke simbol koin tertentu (CSV, tidak sensitif huruf besar/kecil, hingga 100 selektor digabung). Tidak boleh lebih dari 1000 karakter.

sort
string opsional
-marketcap

Field pengurutan dipisahkan koma; awali dengan - untuk menurun. Dapat diurutkan: marketcap, rank, price, volume_24h, change_24h, change_7d. Tidak boleh lebih dari 100 karakter.

interval
string opsional
24h

Jendela penggerak hanya untuk /coins/gainers dan /coins/losers: 24h atau 7d.

Salah satu dari: 24h 7d

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/wallets/frostsnap/assets?page=1&per_page=50&type=coin&status=active&search=bitcoin&min_price=0.5&max_price=100000&min_marketcap=1000000&max_marketcap=5000000000000&min_volume=1000000&max_volume=100000000000&ids=38%2C39&slugs=bitcoin%2Cethereum&symbols=BTC%2CETH&sort=-marketcap&interval=24h" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
3 endpoint

Pasar Global

Agregat seluruh pasar — total marketcap dan volume, jumlah asset/exchange/pair/market, dominasi BTC/ETH dengan top-3 berbasis peringkat, pembacaan Fear & Greed pasar, plus heatmap top-100 dan riwayat marketcap/volume.

Snapshot pasar global

Ikhtisar pasar sekali panggil: total marketcap dan volume 24 jam, jumlah cryptocurrency / token / exchange / pair / market, dominance (pangsa BTC & ETH plus top3 berbasis peringkat), dan pembacaan fear_greed pasar.

GET
http://localhost/api/v1/global
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/global" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Heatmap pasar

Baris treemap top-100 plus statistik pembingkai (total marketcap/volume, dominasi, dan skor Fear & Greed pasar) — kembaran API dari heatmap web.

GET
http://localhost/api/v1/global/heatmap
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/global/heatmap" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Riwayat marketcap / volume global

Deret waktu total-pasar untuk marketcap atau volume. Granularitas mengikuti period: 24h = half-hourly, 7d = hourly, 30d/all = daily (rollup yang lebih halus dipangkas).

GET
http://localhost/api/v1/global/history/{metric}
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

metric
string wajib
marketcap

Seri yang mana: marketcap atau volume.

Parameter query

period
string opsional
7d

24h, 7d, 30d atau all (bawaan 24h).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/global/history/marketcap?period=7d" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
6 endpoint

Sentimen

Indeks sentimen pasar dan per koin. Fear & Greed dan Bull/Bear adalah SNAPSHOT yang diperbarui setiap 15 menit — hanya pembacaan saat ini yang ada, tidak ada deret waktu untuknya. Altseason membawa riwayat harian lengkap. indicators adalah perhitungan teknikal seluruh pasar.

Perhitungan suara komunitas

Perhitungan komunitas bullish/bearish koin selama jendela 24 jam bergulir.

GET
http://localhost/api/v1/coins/{slug}/votes
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
bitcoin

Identifier slug koin.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/coins/bitcoin/votes" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Berikan suara sentimen

Memberikan suara sentimen pemilik key untuk sebuah koin. Satu suara per pemilik key per koin per jendela 24 jam bergulir — memberi suara ulang dalam jendela tersebut memperbarui suara yang ada.

POST
http://localhost/api/v1/coins/{slug}/votes
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
bitcoin

Identifier slug koin.

Parameter body

vote
string wajib
bullish

Sentimen Anda: bullish atau bearish.

Permintaan

curl --request POST \
    "http://localhost/api/v1/coins/bitcoin/votes" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"vote\": \"bullish\"
}"

Indeks Fear & Greed

Pembacaan Fear & Greed saat ini (snapshot 15 menit — tanpa riwayat). Kosongkan coin untuk indeks seluruh pasar, atau berikan slug koin untuk pembacaan per koin. intervals membawa sub-skor 7d/30d dan rincian komponennya.

GET
http://localhost/api/v1/sentiment/fear-greed
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

coin
string opsional
bitcoin

Slug koin untuk pembacaan per koin; kosongkan untuk indeks pasar.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/sentiment/fear-greed?coin=bitcoin" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Indeks Bull / Bear

Pembacaan Bull/Bear saat ini (snapshot 15 menit — tanpa riwayat). Kosongkan coin untuk indeks seluruh pasar, atau berikan slug koin untuk pembacaan per koin.

GET
http://localhost/api/v1/sentiment/bull-bear
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

coin
string opsional
bitcoin

Slug koin untuk pembacaan per koin; kosongkan untuk indeks pasar.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/sentiment/bull-bear?coin=bitcoin" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Indeks altseason

Pembacaan altseason saat ini (jumlah koin yang mengungguli BTC dari top 100), dengan history harian opsional. Tidak seperti Fear & Greed, altseason memiliki riwayat harian lengkap — berikan days untuk menyertakannya.

GET
http://localhost/api/v1/sentiment/altseason
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

days
integer opsional
30

Jumlah hari riwayat harian yang disertakan (1–365; 0/kosong = hanya saat ini).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/sentiment/altseason?days=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Perhitungan indikator pasar

Perhitungan teknikal seluruh pasar — 25 kategori indikator dirangkum, masing-masing dengan status saat ini, skor, dan data kategorinya.

GET
http://localhost/api/v1/sentiment/indicators
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/sentiment/indicators" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
2 endpoint

Indikator

Indikator teknikal per koin — snapshot multi-indikator plus deret waktu harian per keluarga. Semua keluarga adalah seri HARIAN yang dihitung dari candle harian (retensi penuh; aset muda mengembalikan null pemanasan hingga riwayat cukup). Keluarga skala-harga (sma, vwap, macd, obv) memancarkan string desimal; osilator terbatas memancarkan angka. Beberapa periode jendela panjang memerlukan paket berbayar (lihat endpoint keluarga).

Snapshot indikator

Snapshot multi-indikator — state terbaru setiap kategori indikator (bullish/bearish/sheepish…), score, dan data mentah, dalam satu payload.

GET
http://localhost/api/v1/coins/{slug}/indicators
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
bitcoin

Slug koin.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/coins/bitcoin/indicators" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Seri keluarga indikator

Deret waktu harian satu keluarga indikator. Keluarga dengan beberapa jendela menerima period, dan jendela valid berbeda per keluarga: RSI/Stoch-RSI 7/14/21/28, SMA 50/100/200, CCI 20/50/100, MFI 7/14/28, Williams %R 14/20/50, price/volume-volatility 7/14/30. Keluarga seri tunggal (MACD, OBV, ADX, VWAP, CMF) mengabaikan period. Koin muda mengembalikan null pemanasan di awal.

Beberapa jendela panjang memerlukan paket berbayar: RSI & Stoch-RSI 21/28 hari dan jendela volatilitas 30 hari memerlukan Starter atau lebih tinggi — memintanya pada paket Free mengembalikan 403 dengan kode plan_required.

GET
http://localhost/api/v1/coins/{slug}/indicators/{family}
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
bitcoin

Slug koin.

family
string wajib
rsi

Keluarga indikator — salah satu dari rsi, stoch-rsi, sma, cci, mfi, williams-r, price-volatility, volume-volatility, macd, obv, adx, vwap, cmf.

Parameter query

period
integer opsional
14

Panjang jendela (hanya jika keluarga memiliki jendela; harus salah satu jendela valid keluarga tersebut).

start
string opsional
2026-06-01

Batas bawah tanggal ISO.

end
string opsional
2026-06-30

Batas atas tanggal ISO.

limit
integer opsional
30

Baris maksimum (1–1000, bawaan 365).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/coins/bitcoin/indicators/rsi?period=14&start=2026-06-01&end=2026-06-30&limit=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
6 endpoint

Likuidasi

Likuidasi derivatif. Cakupan sumber saat ini hanya pasar swap OKX (dinyatakan di setiap meta.note). Feed MENTAH (daftar /liquidations dan rincian per jam) dipangkas setelah ~48 jam; rollup harian disimpan selamanya. Agregat hari ini bersifat parsial dan diperbarui setiap ~15 menit.

Feed likuidasi

Feed likuidasi mentah (~48 jam terakhir, lalu dipangkas), terbaru dulu. Cakupan sumber saat ini adalah pasar swap OKX. Harga berupa string desimal. meta membawa field paginasi plus retention dan note.

GET
http://localhost/api/v1/liquidations
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

page
integer opsional
1

Nomor halaman (dimulai dari 1). Harus minimal 1.

per_page
integer opsional
50

Baris per halaman. Batas berbasis paket (Free 100, Starter/Pro 250); melampauinya mengembalikan 422 alih-alih membatasi. Harus minimal 1. Tidak boleh lebih dari 100.

exchange
string opsional
okx

Batasi ke satu bursa berdasarkan slug. Cakupan sumber saat ini adalah pasar swap OKX. Harus cocok dengan regex /^[a-z0-9-]{1,120}$/.

instrument
string opsional
swap

Tipe instrumen: future, option, swap, spot atau margin.

Salah satu dari: future option swap spot margin

position
string opsional
short

Sisi posisi yang dilikuidasi: long atau short.

Salah satu dari: long short

order
string opsional
buy

Sisi eksekusi yang memicu likuidasi: buy atau sell.

Salah satu dari: buy sell

symbol
string opsional
BTC

Pencocokan prefiks pada instId venue (mis. BTC cocok dengan BTC-USDT-SWAP). Harus cocok dengan regex /^[A-Za-z0-9$.-]{1,25}$/.

min_usd
number opsional
1000

Hanya likuidasi dengan nilai USD pada atau di atas ambang ini. Harus minimal 0.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/liquidations?page=1&per_page=50&exchange=okx&instrument=swap&position=short&order=buy&symbol=BTC&min_usd=1000" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Likuidasi per jam

Total USD long/short per jam atas feed mentah. Karena feed mentah dipangkas pada ~48 jam, hours dibatasi hingga 48. Cakupan sumber saat ini adalah pasar swap OKX.

GET
http://localhost/api/v1/liquidations/hourly
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

hours
integer opsional
24

Jendela lihat-balik dalam jam (1–48, bawaan 24).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/liquidations/hourly?hours=24" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Likuidasi harian

Agregat harian (disimpan selamanya), dijumlahkan lintas bursa/instrumen per hari — total/long/short USD plus jumlah posisi long/short. Baris hari ini bersifat parsial dan diperbarui setiap ~15 menit. Cakupan sumber saat ini adalah pasar swap OKX.

GET
http://localhost/api/v1/liquidations/daily
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

days
integer opsional
30

Jumlah hari kalender termasuk hari ini (1–365, bawaan 30).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/liquidations/daily?days=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Ringkasan likuidasi hari ini

Hari ini sejauh ini — total/long/short USD, jumlah posisi, dan dominance long-vs-short. Angka bersifat parsial dan diperbarui setiap ~15 menit; data bernilai null hingga likuidasi pertama hari itu tercatat. Cakupan sumber saat ini adalah pasar swap OKX.

GET
http://localhost/api/v1/liquidations/summary
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/liquidations/summary" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Netflow likuidasi

Aliran USD likuidasi long-vs-short per hari selama jendela. Cakupan sumber saat ini adalah pasar swap OKX.

GET
http://localhost/api/v1/liquidations/netflow
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

days
integer opsional
30

Jumlah hari kalender termasuk hari ini (1–90, bawaan 30).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/liquidations/netflow?days=30" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Koin paling banyak dilikuidasi

Koin teratas berdasarkan volume likuidasi selama jendela terkini, dengan pembagian USD long/short per koin. Cakupan sumber saat ini adalah pasar swap OKX.

GET
http://localhost/api/v1/liquidations/coins
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

hours
integer opsional
24

Jendela lihat-balik dalam jam (1–48, bawaan 24).

limit
integer opsional
8

Jumlah koin yang dikembalikan (1–20, bawaan 8).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/liquidations/coins?hours=24&limit=8" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
3 endpoint

Konversi

Konversi antara dua aset aktif mana pun (kripto DAN fiat), dan daftar mata uang yang dapat digunakan sebagai kaki konversi. Nilai berupa string desimal. Kurs FX fiat diperbarui ~dua kali sehari; kurs kripto ~setiap menit.

Konversi antar aset

Konversi sisi-server antara dua aset aktif mana pun (kripto DAN fiat). to menerima CSV untuk konversi multi-target; membalik cukup dengan menukar from/to. Konversi bersifat linear, sehingga value = unit_rate * amount. Kurs FX fiat diperbarui ~dua kali sehari; kurs kripto ~setiap menit.

GET
http://localhost/api/v1/convert
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

from
string wajib
bitcoin

Slug aset sumber.

to
string wajib
ethereum

Slug aset target, dipisahkan koma (hingga 10).

amount
number opsional
2.5

Jumlah aset sumber yang akan dikonversi (bawaan 1).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/convert?from=bitcoin&to=ethereum&amount=2.5" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Daftar mata uang fiat

Mata uang fiat aktif dengan kurs FX USD-nya: rate_per_usd (satuan per USD) dan inversnya usd_value. Kurs FX fiat diperbarui ~dua kali sehari.

GET
http://localhost/api/v1/fiats
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/fiats" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Daftar kurs konversi

Mata uang pembanding yang dapat digunakan sebagai kaki konversi — fiat, koin, dan token teratas — masing-masing dengan usd_value ternormalisasi (USD per satu unit). Nilai koin/token diperbarui ~setiap menit; kurs fiat yang lambat di-cache terpisah (~dua kali sehari).

GET
http://localhost/api/v1/rates
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/rates" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
5 endpoint

Kalkulator

Kalkulator finansial sisi-server yang mencerminkan alat web: DCA, laba/rugi, dan pinjaman (yang membaca data pasar ter-cache), plus matematika bunga majemuk dan staking tanpa-status.

Kalkulator DCA

Backtest dollar-cost averaging atas riwayat harga harian nyata koin: satu pembelian sebesar amount per interval antara start dan end. Berikan series=true untuk menyertakan seri lengkap per pembelian.

GET
http://localhost/api/v1/calculators/dca
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

slug
string wajib
bitcoin

Identifier slug koin.

amount
number wajib
100

USD yang dibelanjakan per pembelian (0.01–1,000,000,000).

interval
string wajib
weekly

Irama pembelian: daily, weekly, monthly, quarterly atau yearly.

start
string wajib
2024-01-01

date Tanggal pembelian pertama (setelah 2008-12-31).

end
string opsional
2025-01-01

date Tanggal pembelian terakhir (default hari ini).

series
boolean opsional
false

Sertakan seri per pembelian dalam payload.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/calculators/dca?slug=bitcoin&amount=100&interval=weekly&start=2024-01-01&end=2025-01-01&series=" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Kalkulator laba / rugi

Hasil dari beli-lalu-jual antara dua tanggal historis, menggunakan harga koin sebenarnya pada tanggal-tanggal tersebut. Biaya adalah jumlah USD tetap, bukan persentase.

GET
http://localhost/api/v1/calculators/profit-loss
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

slug
string wajib
bitcoin

Identifier slug koin.

amount
number wajib
1000

USD yang diinvestasikan pada buy_date (0.01–1,000,000,000).

buy_date
string wajib
2023-01-01

date Tanggal pembelian.

sell_date
string wajib
2025-01-01

date Tanggal penjualan (pada/setelah buy_date).

buy_fee
number opsional
10

Biaya pembelian tetap dalam USD (bawaan 0).

sell_fee
number opsional
10

Biaya penjualan tetap dalam USD (bawaan 0).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/calculators/profit-loss?slug=bitcoin&amount=1000&buy_date=2023-01-01&sell_date=2025-01-01&buy_fee=10&sell_fee=10" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Kalkulator bunga majemuk

Matematika murni — tanpa data pasar. Perhatikan bahwa tingkat berlaku PER PERIODE PEMAJEMUKAN (konvensi kalkulator web), bukan per tahun.

GET
http://localhost/api/v1/calculators/compound-interest
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

principal
number wajib
10000

Saldo awal dalam USD.

rate
number wajib
1

Tingkat bunga dalam % per periode pemajemukan.

duration
integer wajib
5

Panjang proyeksi (tahun dibatasi hingga 50).

duration_unit
string opsional
years

years (bawaan) atau months.

compound_frequency
string opsional
monthly

daily, weekly, monthly (bawaan), quarterly atau annually.

contribution
number opsional
100

Setoran berulang dalam USD (bawaan 0).

contribution_frequency
string opsional
monthly

daily, weekly, monthly (bawaan), quarterly atau annually.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/calculators/compound-interest?principal=10000&rate=1&duration=5&duration_unit=years&compound_frequency=monthly&contribution=100&contribution_frequency=monthly" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Kalkulator pinjam vs jual

Meminjam dengan jaminan kripto vs menjualnya — membandingkan kedua skenario menggunakan harga koin SAAT INI. Proyeksi informatif, bukan nasihat keuangan.

GET
http://localhost/api/v1/calculators/loan
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

slug
string wajib
bitcoin

Identifier slug koin.

crypto_amount
number wajib
2

Berapa banyak koin yang Anda pegang.

needed_cash
number wajib
50000

USD yang perlu Anda bebaskan.

term_months
integer opsional
36

Jangka waktu pinjaman dalam bulan (bawaan 36).

interest_rate
number opsional
10

APR pinjaman dalam % (bawaan 10).

ltv
number opsional
50

Rasio loan-to-value dalam % (bawaan 50).

expected_growth
number opsional
25

Perkiraan pertumbuhan harga koin selama jangka waktu dalam % (bawaan 25).

tax_rate
number opsional
25

Pajak keuntungan modal dalam % yang diterapkan pada penjualan (bawaan 25).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/calculators/loan?slug=bitcoin&crypto_amount=2&needed_cash=50000&term_months=36&interest_rate=10&ltv=50&expected_growth=25&tax_rate=25" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Kalkulator imbalan staking

Matematika murni — imbalan staking dengan pemajemukan opsional dan komisi validator. Tidak ada data pasar yang dibaca.

GET
http://localhost/api/v1/calculators/staking
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

amount
number wajib
1000

Jumlah yang di-stake, dalam satuan aset yang di-stake.

period
number wajib
2

Panjang periode staking (dibatasi setara 50 tahun).

period_unit
string opsional
years

years (bawaan), months atau days.

apy
number wajib
5

APY yang diiklankan dalam %.

compound_frequency
string opsional
monthly

never, daily, weekly, monthly (bawaan) atau yearly.

commission
number opsional
10

Komisi validator dalam %, diambil dari imbalan (bawaan 0).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/calculators/staking?amount=1000&period=2&period_unit=years&apy=5&compound_frequency=monthly&commission=10" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
8 endpoint

Editorial

Artikel editorial — hanya yang diterbitkan (ACTIVE). locale memilih bahasa konten dengan fallback bahasa Inggris per field (payload melaporkan locale mana yang benar-benar menang). Artikel dapat difilter berdasarkan tag atau slug coin/exchange/wallet terkait. Pembacaan API sengaja TIDAK menambah jumlah tampilan.

Video koin

Video kurasi yang dilampirkan pada sebuah koin (tab Videos di halaman koin), dipaginasi.

GET
http://localhost/api/v1/coins/{slug}/videos
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
bitcoin

Identifier slug koin.

Parameter query

page
integer opsional
1

Nomor halaman (dimulai dari 1).

per_page
integer opsional
10

Baris per halaman (1–50, bawaan 10).

type
string opsional
review

Filter berdasarkan tipe video (mis. overview, tutorial, explainer, review, analysis, news).

search
string opsional
halving

Pencocokan teks bebas pada judul.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/coins/bitcoin/videos?page=1&per_page=10&type=review&search=halving" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Linimasa wawasan koin

Linimasa wawasan koin — payload yang sama yang digunakan panel wawasan halaman aset, dijendelakan dengan offset/limit.

GET
http://localhost/api/v1/coins/{slug}/insights
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
bitcoin

Identifier slug koin.

Parameter query

locale
string opsional
en

Bahasa konten (fallback ke bahasa Inggris).

offset
integer opsional
0

Baris yang dilewati (0–500, bawaan 0).

limit
integer opsional
5

Baris yang dikembalikan (1–50, bawaan 5).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/coins/bitcoin/insights?locale=en&offset=0&limit=5" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Daftar artikel

Artikel yang diterbitkan, terbaru dulu, dipaginasi. Filter berdasarkan tag atau slug coin / exchange / wallet terkait, atau search teks bebas. Setiap baris adalah ringkasan (judul, subjudul, tag, waktu baca, gambar hero, entitas terkait, tanggal).

GET
http://localhost/api/v1/articles
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

page
integer opsional
1

Nomor halaman (dimulai dari 1).

per_page
integer opsional
20

Baris per halaman (1–50, bawaan 20).

locale
string opsional
en

Bahasa konten (fallback ke bahasa Inggris).

tag
string opsional
guide

Filter berdasarkan tag: news, guide, tutorial, explainer, analysis, review, trading, overview atau information.

coin
string opsional
bitcoin

Filter ke artikel yang terkait dengan slug koin ini.

exchange
string opsional
binance-exchange

Filter ke artikel yang terkait dengan slug bursa ini.

wallet
string opsional
frostsnap

Filter ke artikel yang terkait dengan slug dompet ini.

search
string opsional
halving

Pencocokan teks bebas pada judul/subjudul.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/articles?page=1&per_page=20&locale=en&tag=guide&coin=bitcoin&exchange=binance-exchange&wallet=frostsnap&search=halving" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Ambil artikel

Satu artikel yang diterbitkan dengan isi lengkapnya, tag, gambar hero, penghitung "membantu" dan entitas terkait. locale memilih bahasa konten dengan fallback bahasa Inggris per field (payload melaporkan locale mana yang benar-benar menang).

GET
http://localhost/api/v1/articles/{slug}
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
what-is-bitcoin

Slug artikel.

Parameter query

locale
string opsional
en

Bahasa konten (fallback ke bahasa Inggris).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/articles/what-is-bitcoin?locale=en" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Kirim umpan balik artikel

Mendaftarkan jempol-atas/bawah pada sebuah artikel — penghitung yang sama yang digunakan tombol "membantu" di web. Throttling per key berlaku di hulu.

POST
http://localhost/api/v1/articles/{slug}/feedback
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

slug
string wajib
what-is-bitcoin

Slug artikel.

Parameter body

helpful
boolean wajib
true

true untuk membantu, false untuk tidak membantu.

Permintaan

curl --request POST \
    "http://localhost/api/v1/articles/what-is-bitcoin/feedback" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"helpful\": true
}"

Ambil video

Satu video kurasi dengan id YouTube, judul, tipe, durasi, dan coin/exchange/wallet yang dilampirkan padanya.

GET
http://localhost/api/v1/videos/{id}
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

id
integer wajib
87

Id video.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/videos/87" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Daftar wawasan

Wawasan pasar yang dihasilkan AI, dipaginasi. Filter berdasarkan type, slug coin terkait atau search teks bebas; locale memilih bahasa judul/ringkasan dengan fallback bahasa Inggris.

GET
http://localhost/api/v1/insights
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

page
integer opsional
1

Nomor halaman (dimulai dari 1).

per_page
integer opsional
20

Baris per halaman (1–50, bawaan 20).

locale
string opsional
en

Bahasa konten (fallback ke bahasa Inggris).

type
string opsional
per_asset

Filter berdasarkan tipe wawasan: per_asset, market_overview atau narrative.

coin
string opsional
bitcoin

Filter ke wawasan tentang slug koin ini.

search
string opsional
etf

Pencocokan teks bebas pada judul.

sort
string opsional
first_reported

Urutan pengurutan: first_reported (bawaan) atau last_updated.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/insights?page=1&per_page=20&locale=en&type=per_asset&coin=bitcoin&search=etf&sort=first_reported" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Ambil wawasan

Satu wawasan dengan payload lengkapnya — judul, ringkasan, linimasa artikel sumber dan koin terkait.

GET
http://localhost/api/v1/insights/{id}
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

id
integer wajib
101

Id wawasan.

Parameter query

locale
string opsional
en

Bahasa konten (fallback ke bahasa Inggris).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/insights/101?locale=en" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
3 endpoint

Alarm

CRUD alarm-harga — alarm yang sama yang dikelola aplikasi web. Alarm mengonsumsi saldo inventaris alarm pemilik key, bertipe TARGET pada koin saja, dan pelindung above/below vs nilai saat ini memblokir alarm yang akan memicu dirinya sendiri secara instan. Dilingkup-key (API key menetapkan pemilik) dan tidak pernah di-cache respons.

Daftar alarm

Alarm pemilik key, terbaru dulu, dipaginasi. Filter berdasarkan kanal status, direction atau notification.

GET
http://localhost/api/v1/alarms
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter query

page
integer opsional
1

Nomor halaman (dimulai dari 1).

per_page
integer opsional
25

Baris per halaman (1–100, bawaan 25).

status
string opsional
active

Filter berdasarkan status: active atau triggered.

direction
string opsional
above

Filter berdasarkan arah pemicu: above atau below.

notification
string opsional
email

Filter berdasarkan kanal pengiriman: email, push atau webhook.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/alarms?page=1&per_page=25&status=active&direction=above&notification=email" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Buat alarm

Membuat alarm TARGET pada sebuah koin dan menggunakan satu slot alarm dari saldo pemilik key. Target diperiksa terhadap nilai koin saat ini sehingga alarm tidak dapat memicu dirinya sendiri secara instan: alarm above harus menargetkan lebih dari nilai saat ini, alarm below kurang dari itu.

POST
http://localhost/api/v1/alarms
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter body

name
string wajib
BTC six figures

Label untuk alarm (maks 255 karakter).

coin
string wajib
bitcoin

Identifier slug koin.

metric
string wajib
rate

Metrik yang dipantau: rate, volume atau marketcap.

direction
string wajib
above

Arah pemicu: above atau below.

target
number wajib
100000

Nilai ambang (harus berada di sisi direction dari nilai koin saat ini).

notification
string wajib
email

Kanal pengiriman: email, push atau webhook.

Permintaan

curl --request POST \
    "http://localhost/api/v1/alarms" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"BTC six figures\",
    \"coin\": \"bitcoin\",
    \"metric\": \"rate\",
    \"direction\": \"above\",
    \"target\": 100000,
    \"notification\": \"email\"
}"

Hapus alarm

Menghapus salah satu alarm pemilik key dan mengembalikan slot alarm yang digunakannya.

DELETE
http://localhost/api/v1/alarms/{id}
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

id
integer wajib
42

Id alarm.

Permintaan

curl --request DELETE \
    "http://localhost/api/v1/alarms/42" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
5 endpoint

Webhook

Bitculator mengirim (POST) setiap event sebagai JSON dengan header tanda tangan HMAC:

X-Bitculator-Signature: t=<unix-ts>,v1=<hex hmac_sha256("<ts>.<raw-body>", secret)>
X-Bitculator-Event: alarm.triggered

Verifikasi dengan menghitung ulang HMAC atas "." menggunakan secret endpoint Anda dan membandingkan dalam waktu konstan; tolak jika t lebih tua dari beberapa menit (pelindung replay). Contoh (PHP):

[$t, $v1] = sscanf($_SERVER['HTTP_X_BITCULATOR_SIGNATURE'], 't=%d,v1=%s');
$expected = hash_hmac('sha256', $t.'.'.file_get_contents('php://input'), $secret);
abort_unless(hash_equals($expected, $v1) && abs(time() - $t) < 300, 403);

Event yang didukung: alarm.triggered. Pengiriman dicoba ulang 3× dengan backoff; sebuah endpoint dinonaktifkan otomatis setelah 10 pengiriman gagal berturut-turut.

Daftar endpoint webhook

Endpoint webhook pemilik key, terbaru dulu. Secret penandatanganan tidak pernah disertakan — setiap secret ditampilkan tepat sekali, saat pembuatan.

GET
http://localhost/api/v1/webhooks
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/webhooks" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Buat endpoint webhook

Mendaftarkan endpoint HTTPS (maks 5 per akun) untuk pengiriman event. Respons menyertakan secret penandatanganan — SATU-SATUNYA kali ia ditampilkan, jadi simpan segera.

POST
http://localhost/api/v1/webhooks
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter body

url
string wajib
https://example.com/webhooks/bitculator

URL pengiriman HTTPS. Hanya host publik — alamat internal/privat ditolak.

events
string[] wajib
["alarm.triggered"]

Event yang akan dilanggani. Nilai yang diizinkan: alarm.triggered.

Permintaan

curl --request POST \
    "http://localhost/api/v1/webhooks" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"url\": \"https:\\/\\/example.com\\/webhooks\\/bitculator\",
    \"events\": [
        \"alarm.triggered\"
    ]
}"

Hapus endpoint webhook

Menghapus salah satu endpoint webhook pemilik key. Pengiriman yang tertunda ke endpoint tersebut dibatalkan.

DELETE
http://localhost/api/v1/webhooks/{id}
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

id
integer wajib
7

Id endpoint webhook.

Permintaan

curl --request DELETE \
    "http://localhost/api/v1/webhooks/7" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Kirim event uji

Mengirim event uji alarm.triggered yang ditandatangani (test: true di payload, real signature headers) sehingga penerima dapat diverifikasi secara end-to-end.

POST
http://localhost/api/v1/webhooks/{id}/test
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

id
integer wajib
7

Id endpoint webhook.

Permintaan

curl --request POST \
    "http://localhost/api/v1/webhooks/7/test" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Log pengiriman webhook

Upaya pengiriman endpoint (disimpan 30 hari), terbaru dulu, dipaginasi.

GET
http://localhost/api/v1/webhooks/{id}/deliveries
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Parameter path

id
integer wajib
7

Id endpoint webhook.

Parameter query

page
integer opsional
1

Nomor halaman (dimulai dari 1).

per_page
integer opsional
25

Baris per halaman (1–100, bawaan 25).

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/webhooks/7/deliveries?page=1&per_page=25" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
3 endpoint

Meta

Meta dan introspeksi API: ping terautentikasi untuk memverifikasi key dan tumpukan middleware, penggunaan/kuota key saat ini, serta spesifikasi OpenAPI yang dapat dibaca mesin.

Spesifikasi OpenAPI

Dokumen OpenAPI 3 yang dapat dibaca mesin untuk API ini, sebagai JSON — arahkan codegen atau alat API ke URL ini. Publik: tidak perlu key.

GET
http://localhost/api/v1/openapi.json
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/openapi.json" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Ping

No-op terautentikasi untuk memverifikasi key Data API secara end-to-end (auth.api → burst throttle per paket → kuota bulanan). Ini dihitung terhadap kuota seperti panggilan lainnya.

GET
http://localhost/api/v1/ping
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/ping" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Penggunaan & kuota key

Introspeksi penggunaan untuk pemilik key pemanggil: paket Data API, batas bulanannya, terpakai dan tersisa (selalu cocok dengan header X-Quota-*), jendela periode saat ini, dan rincian per-endpoint / per-token. Penggunaan widget embed memiliki paket dan kumpulan sendiri — tidak pernah muncul di sini.

GET
http://localhost/api/v1/usage
Bearer
bc_••••••••••••••••

Key hanya Bearer dan membawa kemampuan data-api — simpan di sisi server.

Permintaan GET — tanpa body permintaan.

Permintaan

curl --request GET \
    --get "http://localhost/api/v1/usage" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"