Popular FAQs

How do I update my credit card information?
If the name, address or expiration date change on your credit card, please update it.

You may update your payment methods by clicking here. If you are not logged in, you will be asked to do so then re-directed to the My Payment Methods page.
 
You can also reach this page at any time by clicking My Account at the top of this page (if you are logged in, you can access My Account by clicking on your email address), then My Payment Methods under the My Profile heading.

From this screen, you can access and update your credit card information.
How long does the free trial last?
Your free trial is valid for 7 days.

Please contact sales@xignite.com if you need to extend your free trial or have questions after your free trial expires.
I am in the middle of testing your APIs and I ran out of credits. What do I do?
If you need additional credits to complete your evaluation we will gladly help out. Please contact us.

Where can I view the number of free trial credits I have left?
You may view your remaining free credits by clicking here. If you are not logged in, you will be asked to do so then re-directed to the My Free Trial Status page.

You can also reach this page at any time by clicking My Account at the top of this page (of you are logged in, you can access My Account by clicking on your email address), then Check My Free Trial Status under the My APIs heading.
RegistrationError: {Service}: Maximum number of unregistered requests exceeded.
The full message of the error you may encounter is:
RegistrationError: {Service}: Maximum number of unregistered requests exceeded. Your request was authenticated using {an HTTP request parameter|a cookie|an IP address|a SOAP header}. Your username is {username}. Please visit http://www.xignite.com/registration-help for more information.

There are a few possible reasons for encountering this error:
  • If you are a subscriber, you will never receive this error unless you are using an incorrect token to authenticate your requests. To fix the problem, simply review your list of authentication tokens and verify you are using a correct one. You can do this by navigating to My Account and clicking on Manage My API Tokens.
  • If you are not registered or subscribed to the service and did not pass any authentication tokens with your request, then it simply means that we could not authenticate your request and therefore it was rejected. Most likely in this case the error message will say that "Your request was authenticated using an IP address" and your username will be that IP address. This is simply because IP-based authentication is the default authentication method if none others are provided.
  • If you are registered or subscribed to the service and use IP-based authentication, then it could mean that your IP address changed and it is not included in your list of authentication tokens. To fix the problem, simply add the IP address provided in the message to your list of authentication tokens. You can do this by navigating to My Account and clicking on Manage My API Tokens.
  • If you are registered or subscribed to the service and use SOAP Header or HTTP RequestParameter authentication, then it could mean that you are passing the wrong authentication token. To fix the problem, simply review your list of authentication tokens and verify you are using a correct one. You can do this by navigating to My Account and clicking on Manage My API Tokens.
  • If you are only registered for a free trial, this could also mean that you have exceeded your free trial hit limit for this service. To verify this, go to My Account, click on Check My Free Trial Status and check if the Remaining Hits value is 0 for the service you are using. If it is, contact your sales representative or sales@xignite.com to request an extension of your free trial.
If you are not sure of which method you use to authenticate your request, please check the value of the Identity data element returned with your data. This is provided as a standard data element on all APIs. 
  • If Identity = IP, verify that the IP of your server is properly registered. If your IP is dynamic, you should probably use a different method for authentication. You may also believe that you are properly passing a SOAP Header with your requests but this header is not being recognized by our system. IP authentication is not recommended as it is common for IPs to change.
  • If Identity = Cookie, verify that you are passing the proper cookie with your requests. Note that when calling a service using your browser, the system will by default pass a cookie with your requests if it exists. Cookies are set up when you log into your account using your browser.
  • If Identity = Request, this means that our system is reading your username from the 'Header_Username' or '_token' value passed with your POST or GET requests. Verify that you are passing the proper value.
  • If Identity = Header, this means that our system is reading your username from the Username element from the SOAP Header value passed with your SOAP requests. Verify that you are passing the proper value.
How do I add/manage IP addresses for my Xignite Account?
IP authentication is discouraged because your application will break if your IP addresses change. We highly recommend using API token authentication to avoid this problem. If you still wish to use IP authentication, there are a few simple steps to follow in order to add or remove IP addresses on your User Account. When using IP authentication, it is critical the IP is added before any queries are executed or the queries will error.

First, you must log in to the Xignite Web Site - once logged in, follow the steps here:
  1. Go to the Manage My API Tokens page within the My Profile area
     
  2. On that page, click the  button
     
  3. In the Add Token box, change the first dropdown to “IP”
     
  4. In the 2nd blank box that appears, enter the full IP address
     
  5. Once you confirm it is entered correctly, press 
     
  6. Note: To lock in this change, press  or you will not actually Save this new IP to the account.
How many free hits do I get with my free trial?
The number of free trial credits differs per service you choose with your free trial; the amount may range from 5 or 10 credits up to 250 credits.  
Additionally, be mindfull that a single API request may deduct multiple hits depending on the request and the data set returned. For instance, quote requests with multiple symbols will count as one hit per symbol. 
  • To view a summary of your trial account hit credits and usage, visit My Free Trial Status under the My Account section of the website.
  • Details about how hits are calculated for each API are available under the Manage section of each API operation page. 
In your 'per hit' subscriptions, what is a 'hit'?
Our subscriptions let you call a service for a certain number of 'hits'.
The number of 'hits' you consume when calling an API depends on the API and the parameters you pass for this call.
In most cases, a single call (or request) for an API (i.e. GetGlobalDelayedQuote, GetRealTimeMetalQuote, etc.) will count as a single 'hit'.
Some API calls can count for more than one 'hit':
  • Multi-Symbol APIs that take more than one symbol as parameter. Examples include GetGlobalDelayedQuotes in XigniteGlobalQuotes, GetRealTimeMetalQuotes in XigniteMetals or GetHistoricalCrossRates in XigniteCurrencies which count as one hit per symbol.
  • Family APIs that return arrays of data for families of related items. An example would be GetRateFamily in XigniteRates which count as one hit per element in the family. 
  • Table APIs that return multiple quotes structured as a table. An example would be GetRealTimeCrossRateTable in XigniteCurrencies which counts as one hit per cell in the table minus the number of pairs requested (the diagonal).
  • Multi-Call APIs that combine several data sets in one structured call. An example would be GetSpotMarketSummary in XigniteMetals which counts as 4 hits.
Some APIs are also free and count as zero hits because they are provided for convenience. An example is GetFuture in XigniteFutures.
What is an API Token and how do I use it?

An API Token is an alphanumeric code, unique to your Xignite Account, which can be used from any system to validate your API calls. API tokens are passed in the Username field of any SOAP code.  It is also our preferred method of authentication over using IP or E-mail Addresses.  For example, an API Token can be used in a multi-server configuration without following up to add each IP address to your account. If load balancing switches the call to originate/execute from another server, this is seamless when using an API Token. This allows for a more dynamic and error-free configuration. 

To add an API Token to your account, follow these steps:
 

  1. Go to My Account > Manage My API Tokens: https://www.xignite.com/MyAccount/Tokens.aspx
     
  2. Click the blue  button, and select the option “API” from the dropdown
     
  3. The window will say “A random token will be generated.”, then click the blue  button
     
  4. Once you go back to the Token list/table, make sure to click  or it will not actually equip your account with the new Token.
     
  5. Once it saves, you will see the alphanumeric string in the table as a new row.