Riwayat kurs, bukan cuma kurs hari ini
Satu panggilan mengembalikan daftar tanggal dan angka: berapa kursnya, seberapa panjang seri yang Anda dapat, dan berapa dalam yang boleh diminta kredensial Anda. Yang di bawah 30 hari dijual di /fx seharga $0.05; sisanya adalah produk sendiri di /series.
Isi satu panggilan /series
GET /series?from=USD&to=IDR&days=365 menjawab JSON dengan:
- base, quote, rate dan date — kurs referensi pada tanggal terakhir
- series — daftar { date, rate } harian, urut dari lama ke baru
- series_days dan change_pct_over_series — panjang seri dan perubahan sejak titik pertama
- max_days_for_this_call — plafon kredensial ini, supaya agent tahu batasnya tanpa menebak
- source dan note — kurs referensi ECB, bukan kurs jual bank
Seberapa dalam yang bisa dibeli
Tiga puluh hari pertama ikut di /fx seharga $0.05. Setelah itu kedalamannya menentukan harganya, dan plafonnya ditegakkan server, bukan hanya ditulis di sini. Kedalaman dihitung dalam print harian: sumber hanya memuat satu kurs per hari kerja, jadi 1.825 print terbentang lebih jauh dari 1.825 hari kalender:
- sampai 365 print — $0.25 per panggilan, tanpa akun (GET /series)
- 365 print tanpa kuota — lisensi $99 (30 hari), GET /license/pilot
- 1.825 print, lebih dari 5 tahun ke belakang, tanpa kuota — lisensi $399 (30 hari), GET /license/growth
- 3.650 print, lebih dari 10 tahun ke belakang, tanpa kuota — lisensi $700 (90 days), GET /license/enterprise
Pertanyaan yang dijawab data ini
Rerata dan rentang kurs lima tahun terakhir; berapa rupiah bergerak sejak tanggal kontrak; membandingkan dua periode sebelum mengambil keputusan harga; atau menempelkan seri langsung ke spreadsheet tanpa mengunduh berkas siapa pun.
Cara membayar
Panggilan yang belum dibayar dijawab 402 dengan jumlah, jaringan, dan alamat tujuan di dalamnya: USDC di Base, Polygon, Arbitrum, atau Avalanche lewat x402, atau lewat rail MPP/Tempo dari 402 yang sama. Token lisensi datang di dalam respons yang Anda bayar dan dipakai sebagai Authorization: Bearer. Kalau transfer sudah dilakukan di wallet lain, klaim dengan hash transaksi di /license/claim.
Pertanyaan umum
Kenapa rentang 5 dan 10 tahun tidak dijual per panggilan?
Supaya ada isi yang benar-benar membedakan tingkat lisensi. Sampai 365 hari siapa pun bisa beli per panggilan seharga $0.25; di atas itu hanya pemegang lisensi growth dan enterprise. Datanya sendiri publik (kurs referensi ECB), jadi yang dijual adalah akses JSON tanpa kuota pada kedalaman itu, bukan datanya.
Sumber dan frekuensi datanya apa?
Kurs referensi harian ECB/BoE lewat Frankfurter, diperbarui pada hari kerja Eropa. Ini kurs referensi, bukan kurs jual bank atau rate money changer.
Lisensi $19 dapat riwayat berapa?
Tidak bertambah. Pada tingkat $19 /series tetap ditagih per panggilan seperti pengunjung biasa; plafon 365 hari baru terbuka dari $99. Itu pilihan sadar supaya selisih harga antar tingkat bisa diperiksa, bukan hanya diklaim.
Berapa lama prosesnya?
Satu transfer, satu respons. Token lisensi sudah ada di dalam body panggilan yang Anda bayar; tidak ada provisioning manual dan tidak ada surel masuk.
Selengkapnya