Supporto & FAQ
Trova risposte alle domande comuni o metti in contatto con il nostro team.
Contatta l'assistenza
Per fatturazione, onboarding, integrazione API o qualsiasi altra domanda, scrivici direttamente via email. Rispondiamo tipicamente entro 1 giorno lavorativo.
Per gli impegni a livello di servizio, consultare il Supporto SLA.
Tutte le richieste sono gestite tramite un'unica casella di posta: info@fxmacrodata.com.
Gestione supporto
Componi un'email di triage più veloce
Includi l'endpoint e il contesto della richiesta così possiamo diagnosticare i problemi più velocemente.
Stato
Salute della piattaforma
Per le cronologie degli incidenti e gli aggiornamenti a livello di componente, consulta il feed esterno: fxmacrodata.statuspage.io.
Principali link di aiuto
Sblocca la situazione più velocemente
Endpoint popolari
Inizia con chiamate API ad alto segnale
Ogni scheda mappa l'intento della funzionalità a una famiglia di endpoint concreta e a un punto di ingresso della documentazione.
Annunci
/api/v1/announcements/{currency}/{indicator}
Valori di rilascio point-in-time con timestamp di annuncio.
Calendario dei rilasci
/api/v1/calendar/{currency}
Prossimi annunci macro per valuta e indicatore.
Forex
/api/v1/forex/{base}/{quote}
Tassi spot storici con overlay tecnici opzionali.
Tassi & Curve
/api/v1/rate_differentials/{base}/{quote}
Spread di carry, snapshot della curva, proxy di pendenza e segmenti forward derivati.
COT
/api/v1/cot/{currency}
Posizionamento settimanale non commerciale dai report CFTC.
Materie Prime
/api/v1/commodities/{indicator}
Serie di commodity e metalli utilizzate nell'analisi dei regimi macro.
Sessioni di Mercato
/api/v1/market_sessions
Stato attuale di apertura/chiusura per le principali finestre di sessione FX.
Domande frequenti
Dati & Copertura
Quanto sono in tempo reale i dati?
FXMacroData monitora i rilascio ufficiali supportati e registra le prove di pubblicazione e raccolta dove disponibili. La copertura temporale varia in base alla fonte e al rilascio; publication_time_status identifica orari di pubblicazione confermati, non verificati, storici stimati e sconosciuti.
Quali fonti di dati sono incluse?
I rilascio macroeconomici provengono dagli editori originali, inclusi agenzie statistiche nazionali, dipartimenti governativi e banche centrali come la ECB e la RBA. Consulta ogni serie' i metadati della fonte per l'editore e la misura sottostante.
Posso accedere ai dati storici?
Sì. I dati storici completi sono disponibili con un abbonamento Individual, Business o Enterprise. Gli utenti non abbonati possono accedere agli endpoint delle serie temporali freemium per i più recenti 90 giorni, 15 minuti dopo la pubblicazione di ogni rilascio.
Quali endpoint sono gratuiti rispetto a quelli a pagamento?
Senza una chiave API, e senza account o scadenza, puoi utilizzare i dati degli annunci USD per i più recenti 90 giorni (ogni rilascio 15 minuti dopo la pubblicazione), il calendario dei rilasci USD, il catalogo dei dati, le sessioni di mercato, i comunicati stampa ufficiali USD e il posizionamento USD COT, fino a 100 richieste al giorno. I valori previsionali (USD inclusi), i rilasci in tempo reale, lo storico completo, i dati non-USD, i tassi FX e le materie prime richiedono una chiave API di un piano Individual, Business o Enterprise.
Quante valute sono supportate?
La piattaforma copre 22 valute in totale, con annunci pubblici e copertura del catalogo attualmente pubblicati per 22 valute e copertura del calendario di rilascio pubblicata per 20. Vedi il documentazione per i dettagli della copertura per singolo endpoint.
Fatturazione & Abbonamento
La prova gratuita richiede una carta di credito?
Sì. La prova di 14 giorni richiede una carta di credito valida al momento dell'iscrizione. Non ti verrà addebitato nulla fino alla fine della prova.
Posso annullare in qualsiasi momento?
Sì, puoi annullare l'abbonamento dalle impostazioni del tuo piano prima del prossimo ciclo di fatturazione. Senza domande.
Cosa succede quando la prova gratuita termina?
L'abbonamento si converte automaticamente nel piano a pagamento a meno che non venga annullato prima della fine della prova. È possibile gestire questa operazione nelle impostazioni di fatturazione.
Cosa succede se il mio metodo di pagamento fallisce?
Se il pagamento non può essere elaborato, l'accesso all'account potrebbe essere limitato fino all'aggiornamento delle informazioni di fatturazione. Vedi termini di fatturazione per i dettagli.
Quali metodi di pagamento sono accettati?
Accettiamo tutte le principali carte di credito (Visa, Mastercard, Amex) tramite il nostro processore di pagamento sicuro Stripe.
Tecnico & Integrazione
Supportate altri linguaggi di programmazione?
Sì. L'ufficiale Python SDK è disponibile tramite pip install fxmacrodata, e il REST API funziona con qualsiasi linguaggio — Go, R, Java, C#, MATLAB, Rust e altri. Vedi guide quickstart per esempi.
Esiste un server MCP per assistenti AI?
Sì. FXMacroData supporta il Model Context Protocol (MCP), consentendoti di connettere Claude, Cursor e altri strumenti AI direttamente ai nostri dati. Vedi il docs server MCP.
Come autentico le richieste API?
Invia la tua chiave API in un'intestazione della richiesta: X-API-Key: YOUR_API_KEY. È accettato anche Authorization: Bearer. Chiama il API dal tuo server: non invia intestazioni CORS ai browser. Trova la tua chiave nella dashboard di gestione API dopo l'abbonamento.
Quale supporto è incluso nel mio piano?
Tutti i piani a pagamento includono il supporto via email per l'integrazione e domande sui dati. Il piano Business aggiunge il supporto prioritario, e gli accordi Enterprise possono includere opzioni SLA personalizzate. Vedi obiettivi di risposta del supporto.
Quant & Backtesting
Il punto dati è point-in-time / privo di lookahead bias?
La riproduzione point-in-time dipende dalle evidenze conservate per ogni serie storica del valore. Controlla announcement_datetime insieme a publication_time_status, publication_time_precision e vintage_status. Usa as_of con availability=public o availability=captured per selezionare i valori storici idonei, quindi ispeziona data_quality.point_in_time_safe. Un filtro per data da solo non rimuove le revisioni successive, e un timestamp di pubblicazione o raccolta non prova quando un cliente ha potuto leggere il valore tramite API.
Posso usare questi dati con pandas, NumPy o framework di backtesting?
Sì. Tutte le risposte API restituiscono JSON pulito che si converte direttamente in un pd.DataFrame. announcement_datetime e generated_at utilizzano i secondi dell'epoca Unix; i campi in ora locale utilizzano stringhe ISO 8601 con un offset. I campi al nanosecondo hanno anche varianti di stringhe decimali per preservare la precisione. Usa pd.concat()per combinare serie compatibili dopo aver verificato unità e prove temporali. Le giunzioni sensibili al tempo possono usare merge_asof.
I valori dei dati revisionati sono memorizzati separatamente dai rilasci iniziali?
Dove conservati, i vintage dei valori appaiono in revisions[]. Richiedi revisions=all per ispezionare la cronologia disponibile per un'osservazione. Per la riproduzione, usa as_of con revisions=latest per selezionare l'ultimo vintage idoneo al tuo cutoff. Controlla vintage_status e is_first_release: il primo valore catturato non è necessariamente il pubblicatore'la sua prima stampa, e la cronologia completa delle revisioni non è disponibile per ogni serie.
Quanto indietro risalgono i dati storici?
La profondità storica varia in base all'indicatore e alla fonte della banca centrale. La maggior parte dei principali indicatori (CPI, GDP, tasso di politica monetaria, disoccupazione) copre almeno 10 anni. I rendimenti obbligazionari e alcuni indicatori secondari hanno cronologie più brevi. Vedi catalogo indicatori per i dettagli sulla copertura per metrica.
Posso ridistribuire i dati in pubblicazioni di ricerca o prodotti?
I diritti di ridistribuzione dipendono dal tuo piano. Individuale e Aziendale coprono il proprio uso interno. La Ridistribuzione Commerciale è l'add-on self-service per la visualizzazione clienti leggibile dall'uomo con attribuzione. Dopo la prova viene fatturato a USD 10 per blocco di pubblico al mese, a partire da un blocco indipendentemente dalle dimensioni del tuo pubblico. Un blocco copre fino a 100 utenti o destinatari misurati, o fino a 1,000 follower dichiarati su un feed social o di trasmissione pubblico, e ogni superficie registrata contribuisce ai blocchi di una quantità a livello di account. Il pass-through di API grezzi, i file bulk, i feed di dati e la rivendita nel marketplace sono esclusi. Non c'è domanda, preventivo, coda di approvazione o tempo di attesa. Vedi Termini di Servizio per tutti i dettagli.
Hai bisogno di aiuto
Hai ancora domande?
Se la documentazione o le FAQ non coprono il tuo caso d'uso, contattaci includendo il percorso dell'endpoint, l'intervallo di date e il timestamp della richiesta.
Perché i team si fidano
Fonti ufficiali
I valori di rilascio provengono da editori ufficiali, banche centrali e uffici di statistica.
Timestamp di rilascio
Le righe di annuncio conservano i timestamp di rilascio UTC per studi sugli eventi, dashboard, lavori di ricerca e sistemi live.
Decenni di cronologia
I record point-in-time mostrano ciò che era noto in ogni data, in modo che i backtest non utilizzino informazioni future.