Disse svar dækker almindelige tekniske spørgsmål om integration med API'et til valutadata. Se API-dokumentationen for alle endpoints og parametre. Se Hvordan fungerer API'et til valutadata? for en oversigt over vores kurser.

I denne artikel

• Hvilket endpoint skal jeg bruge til hver type kurs?
• Hvordan får jeg den komplette liste over valutaer?
• Hvilke valutapar dækker endpointet for købs- og salgskurser?
• Hvordan håndterer API'et forældede valutaer?
• Hvordan får jeg købs- og salgskurser fra en centralbank?
• Hvorfor ser en centralbankkurs ud, som om den er fra dagen før?
• Må jeg cache kurser fra API'et?
• Hvordan får jeg kursen fra en tidligere dag på mit fastlåsningstidspunkt?
• Hvordan finder jeg SSL-certifikatet til API'et?
• Hvorfor får jeg timeout eller 500-fejl?
• Skal jeg tillade IP-adresser på en allowliste?
• Hvorfor får jeg 401- eller 403-fejl?

Hvilket endpoint skal jeg bruge til hver type kurs?

Kryptovalutakurser kommer fra vores mid-market-kurser, så du anmoder om dem via mid-market-endpoints. Tilføj crypto=true til din anmodning for at inkludere dem.

Hvordan får jeg den komplette liste over valutaer?

Brug endpointet /v2/currencies. For hver valuta viser det:

• om den er en ISO 4217-kode
• datoen, hvor den blev introduceret, og hvis den er forældet, datoen, hvor den blev trukket tilbage
• datoerne, hvor vores kurser for den starter og slutter
• den valuta, der erstattede den, samt eventuel binding

Som standard indeholder listen aktive og forældede valutaer. Sådan ændrer du dette:

• tilføj obsolete=true for kun at vise forældede valutaer, som vi har historiske data for
• tilføj obsolete=false for at erstatte forældede valutaer med den valuta, der erstattede dem

Hvilke valutapar dækker endpointet for købs- og salgskurser?

Endpointet /v1/bid_ask dækker AUD, BRL, CAD, CHF, CNH, DKK, EUR, GBP, JPY, NOK, NZD, PLN, SEK og USD.

Du kan anmode om alle par i begge retninger, bortset fra disse par med CNH (offshore-kinesisk yuan):

• CNH er ikke tilgængelig med BRL, DKK eller PLN i nogen af retningerne.
• CNH er kun tilgængelig som målvaluta med NOK og SEK. Du kan f.eks. anmode om from=NOK&to=CNH, men ikke om from=CNH&to=NOK.

Hvordan håndterer API'et forældede valutaer?

Valutaer bliver nogle gange omdøbt, redenomineret eller trukket tilbage. Som standard svarer API'et i den valuta, der bruges i dag, så hvis du anmoder om en tilbagetrukket kode, får du kurser for den valuta, der erstattede den. Hvis du vil have kurser for selve den tilbagetrukne kode, skal du tilføje obsolete=true til din anmodning.

Vi beregner kurser for en forældet valuta efter datoen for dens tilbagetrækning ud fra dens faste binding til den valuta, der erstattede den. Det holder lange historikker konsistente, men dette er ikke markedskurser.

Se Historiske kurser og forældede valutaer i API-dokumentationen for flere oplysninger, herunder hvordan vi beregner gennemsnit og statistik på tværs af et valutas skifte.

Hvordan får jeg købs- og salgskurser fra en centralbank?

Tilføj fields=mid,bid,ask til din anmodning til /v1/central_bank_rate. Uden dette får du kun middelkursen.

• Du får kun købs- og salgskurser fra centralbanker, der offentliggør dem. 37 af de 100 centralbanker gør det, herunder Bank of Japan, Hong Kong Monetary Authority, Central Bank of Brazil og Bank of Thailand. Den Europæiske Centralbank, Bank of England og Federal Reserve Bank of New York offentliggør kun referencekurser. Kolonnen Bid/Ask i API-dokumentationen viser, hvilke banker der offentliggør dem.
• Købs- og salgskurser gælder kun for aktuelle kurser. Hvis du tilføjer en date til din anmodning, får du kun middelkursen.
• Dette er de kurser, som hver centralbank offentliggør. De er forskellige fra Xes egne købs- og salgskurser fra endpointet /v1/bid_ask.

Hvorfor ser en centralbankkurs ud, som om den er fra dagen før?

Hvis du ikke angiver en dato, returnerer /v1/central_bank_rate et timestamp i UTC. Når du konverterer det til din lokale tid, kan kursen se ud, som om den er fra dagen før.

Hvis du vil have bankens egen lokale dato i stedet, skal du tilføje use_bank_date=true til din anmodning. For Den Europæiske Centralbank får du f.eks. 2026-08-17 i stedet for 2026-08-16T22:00:00Z. Dette fungerer for JSON-, XML- og CSV-svar.

Må jeg cache kurser fra API'et?

Ja, i en begrænset periode. Caching hjælper din integration med at køre hurtigere og reducerer antallet af anmodninger, du sender. Fjern cachede kurser, når de ikke længere er aktuelle. Caching betyder, at kurser opbevares midlertidigt. Det betyder ikke, at de gemmes permanent.

Hvordan får jeg kursen fra en tidligere dag på mit fastlåsningstidspunkt?

Kald /v1/historic_rate med date=YYYY-MM-DD og use_lock_in_time=true. Du får kursen, som den var på din kontos daglige fastlåsningstidspunkt den pågældende dag. Du kan f.eks. bruge dette til at hente fredagens kurs i den efterfølgende uge.

Dit fastlåsningstidspunkt påvirker ikke centralbankkurser. De følger hver banks egen offentliggørelsesplan.

Hvordan finder jeg SSL-certifikatet til API'et?

Du kan downloade certifikatet fra din browser ved hjælp af Chrome eller Edge.

I Chrome

1. Åbn Chrome, og gå til https://dfs.xe.com/dfs eller https://xecdapi.xe.com/v1.

2. Vælg ikonet for webstedsoplysninger til venstre for adresselinjen.

   

3. Vælg Forbindelsen er sikker, og vælg derefter Certifikatet er gyldigt.

   

4. Gå til fanen Detaljer i vinduet med certifikatoplysninger.

   

5. Vælg Eksportér for at downloade certifikatet til dit system.

   

I Edge

1. Gå til https://dfs.xe.com/dfs eller https://xecdapi.xe.com/v1.

2. Vælg hængelåsikonet i adresselinjen.

   

3. Vælg Forbindelsen er sikker.
4. Vælg certifikatikonet øverst til højre i pop op-vinduet.

5. Åbn fanen Detaljer i certifikatvinduet.

   

6. Vælg Eksportér for at downloade certifikatet.
   
   

Hvorfor får jeg timeout eller 500-fejl?

De fleste periodiske timeouts og 5xx-fejl opstår i netværket eller gatewayen mellem dit system og vores. Før du kontakter os, skal du kontrollere:

• Gateways og middleware: Hvis du kalder API'et via en integrationsplatform eller API-gateway, skal du først kontrollere dens logfiler. Fejl, som den selv opretter, kan ligne fejl fra vores API.
• DNS: Du må ikke hardkode eller cache vores IP-adresse. Opløs xecdapi.xe.com normalt, og respekter DNS TTL'er, da IP-adressen bag den kan ændre sig.
• Timeouts og forbindelsespuljer: Sørg for, at din klients indstillinger tillader den mængde anmodninger, du sender. Fordel store batches i stedet for at sende dem alle på én gang.
• TLS: Din klient skal understøtte TLS 1.2 eller nyere med moderne (GCM) cipher suites. Ældre stacks, såsom Java 7 eller ældre .NET, understøtter muligvis kun CBC-ciphers, som vi er ved at udfase. Du kan teste din klient mod https://xecd-rates-api-test.xe.com/, som kun accepterer TLS 1.3 samt TLS 1.2 med GCM.

Hvis fejlene fortsætter, kan du sende en e-mail til data@xe.com med dit konto-id, endpointet og parametrene, UTC-tidspunkterne for fejlene samt hele fejlsvaret.

Skal jeg tillade IP-adresser på en allowliste?

Nej. API'et til valutadata begrænser ikke kaldere efter IP-adresse. Du kan kalde https://xecdapi.xe.com fra enhver offentlig IP-adresse, og du behøver ikke registrere din hos os.

Hvis din firewall kun tillader udgående trafik til faste IP-adresser, skal du bruge vores statiske IP-endpoint, xecd-proxy.xe.com, og føje dets IP-adresse til din allowliste for den aktuelle IP. Vi sender en e-mail til alle, der bruger dette endpoint, før dets IP-adresse ændres og før planlagt vedligeholdelse.

• Brug kun xecd-proxy.xe.com, hvis du har brug for en fast IP-adresse. Ellers skal du kalde xecdapi.xe.com direkte.
• Hvis anmodninger begynder at mislykkes efter en netværksændring hos dig, skal du kontrollere, at din firewalls allowliste stadig indeholder vores statiske IP-adresse.

Hvis du bruger det ældre Datafeed (DFS)

DFS accepterer kun anmodninger fra IP-adresser på allowlisten. Hvis dine kontor- eller server-IP-adresser ændrer sig, skal du sende os de nye. Hvis du skifter til API'et, behøver du ikke tillade IP-adresser på en allowliste.

Hvorfor får jeg 401- eller 403-fejl?

• 401 Ugyldige legitimationsoplysninger: Kontrollér det konto-id og den API-nøgle, som din integration sender. Begge skelner mellem store og små bogstaver.
• 403 "exceeded max number of access attempts": Efter 3 mislykkede godkendelsesforsøg blokerer vi kontoen i op til 5 minutter. Blokeringen gælder for alle integrationer på kontoen, også dem, der bruger de korrekte legitimationsoplysninger. Det betyder normalt, at et andet system, f.eks. en gammel server eller et testscript, stadig sender en forældet nøgle.

Sådan løser du en 403-fejl:

1. Find det system, der sender den gamle nøgle, og opdatér det, eller slå det fra.
2. Vent 5 minutter, og prøv derefter igen.