API Terms of Service and Data Disclaimer
Last updated:
1. Agreement to these terms
These API Terms of Service (the "Terms") govern your use of the Karatology Metal Price API (the "API"), the API dashboard, the documentation and related services (together, the "Service") provided by Karatology ("Karatology," "we," "us" or "our").
By creating an account, generating an API key or calling the API, you agree to these Terms. If you use the Service for a business or other organization, you confirm that you are authorized to accept these Terms on its behalf, and "you" includes that organization. If you do not agree, do not use the Service.
2. The service
The API returns live market prices for gold, silver, platinum and palladium in US dollars, along with values calculated from them, such as prices by karat and fineness, melt value and cross-metal ratios. Prices are fetched when you make a request. New prices are collected hourly, and each response states when its price was collected.
The endpoints, parameters, response formats and limits of the API are described in the API documentation and on the pricing page, which form part of these Terms.
3. Accounts and API keys
- You must provide accurate account information, keep it up to date, and be at least 18 years old or the age of majority where you live.
- API keys are shown once when you create them. Keep your keys and your account password secret. Do not publish keys, share them outside your organization, or commit them to public code repositories.
- You are responsible for all activity on your account and for all use of your keys, including calls made by anyone who obtains a key from you or from your code. A key used in browser code is visible to visitors of that page; if you use a key that way, you accept that risk.
- If you believe a key has been exposed, roll or revoke it from your dashboard right away and let us know.
- Karatology may revoke, disable or limit any key that we reasonably believe is compromised, abused or used in breach of these Terms.
4. Plans, billing and renewals
- Paid plans are subscriptions billed in advance, monthly or yearly, in US dollars. Payments are processed by our payment provider, Stripe, and your card details are handled by Stripe.
- Subscriptions renew automatically at the end of each billing period at the current price for your plan until you cancel. If the price of your plan changes, we will tell you in advance, and the new price applies from your next renewal after that notice.
- You can cancel at any time from the billing page in your dashboard. Cancellation takes effect at the end of the current billing period. Your plan stays active until then, after which your account moves to the Free plan.
- Fees are not refundable. We do not give refunds or credits for partial billing periods, unused calls or downgrades, unless required by law.
- If a payment fails, your paid plan continues for a grace period of 7 days while the payment is retried. If payment is still not completed after that, API requests return a payment_required error until you update your payment method or cancel.
- Prices do not include taxes unless stated. You are responsible for any taxes that apply to your purchase.
5. Free plan
The Free plan includes 10 successful calls a month, 5 requests a minute and 1 API key. It is provided for testing, evaluation and development, not for production use, and it stops at its monthly limit with no grace.
Each person or organization may hold one Free account. Creating extra accounts to get more free calls is not allowed. We may change the Free plan's limits, or end the Free plan, with notice.
6. Usage limits and metering
- Each plan has a monthly call quota and a per-minute rate limit, shown on the pricing page. Monthly quotas reset at 00:00 UTC on the 1st of each month.
- Only successful responses from price endpoints count toward your quota. Errors, usage checks, reference data and preflight requests are not counted.
- Paid plans may run up to 10% over their included calls. After that, requests return a quota_exceeded error until the quota resets or you upgrade. We do not charge overage fees.
- Per-minute limits apply to every authenticated request and are shared by all keys on an account.
- Our metering records are used to count your usage. If you believe a count is wrong, contact us and we will review it.
7. Acceptable use
You may use data from the API in your own websites, apps, in-store displays, internal tools, newsletters and products you offer to your customers, including showing prices and values you derive from it.
You may not:
- resell, sublicense, redistribute or republish the raw price feed, in bulk or in a form that lets others use it in place of the API, including offering it as a competing data service, feed or API;
- scrape the API or the Karatology website, share keys or create multiple accounts, or use any other method to get around rate limits, quotas or access controls;
- run load tests or stress tests against the API, or send traffic meant to degrade or disrupt the Service;
- probe, scan or test the security of the Service, or try to bypass authentication, without our written permission;
- present prices or values from the API as an appraisal, a guaranteed value, or a binding offer to buy or sell;
- use the Service for any unlawful purpose, to mislead consumers, or in breach of laws that apply to you, including consumer protection and advertising laws; or
- reverse engineer the Service, except to the extent the law allows despite this restriction.
8. Data disclaimer
- Prices and values returned by the API are indicative market prices provided for information only.
- Prices may be delayed. New prices are collected hourly, and each response includes the time its price was collected (timestamp), its age in seconds (age_seconds) and a stale flag. You are responsible for checking these fields before relying on a price.
- Prices are not an offer or solicitation to buy or sell any metal, are not a quote at which anyone will trade, and must not be used to settle trades, contracts or financial instruments.
- Karat, fineness and melt values are calculated by multiplying a spot price by purity. They exclude labor, design, gemstones, refining and assay costs and dealer margins. They are not an appraisal and not a guaranteed value of any item. Payout values only apply the percentage you supply.
- We do not warrant that the data is accurate, complete, current or timely, or that it matches prices quoted by any dealer, refiner or exchange.
- Nothing in the Service is financial, investment, tax or legal advice.
- If you show data from the API to your own customers, you are responsible for how you present it, including making clear that prices are indicative and may be delayed.
To learn how karat and fineness relate to purity, see our gold karat chart.
9. Availability and changes to the service
We work to keep the Service available, but we do not guarantee any level of uptime, availability or response time unless a separate written agreement signed by Karatology says otherwise. The Service may be interrupted for maintenance, upgrades, failures of systems we rely on, or events outside our control. When live prices cannot be fetched, the API returns a prices_unavailable error rather than a guessed price.
We may add, change or remove endpoints, fields and features. We will try to give reasonable notice before a change that breaks existing integrations with version 1 of the API.
10. Suspension and termination
You may stop using the Service at any time. To close your account, cancel any paid plan and email us.
We may suspend or end your access, or revoke your keys, if you breach these Terms, if your use creates a risk to the Service or to other customers, if payment is overdue past the grace period, or if the law requires it. Where it is reasonable to do so, we will give notice first. If we end your paid plan for a reason other than your breach of these Terms, we will refund any prepaid fees for the unused part of the billing period.
11. Disclaimer of warranties
The Service and all data are provided "as is" and "as available." To the fullest extent permitted by law, Karatology disclaims all warranties, express or implied, including warranties of merchantability, fitness for a particular purpose, accuracy, non-infringement and uninterrupted or error-free operation.
12. Limitation of liability
To the fullest extent permitted by law:
- Karatology is not liable for any indirect, incidental, special, consequential or punitive damages, or for lost profits, revenue, data or business opportunities, including losses from pricing, buying, selling or trading decisions made using the data, even if we were told such losses were possible.
- Karatology's total liability for all claims relating to the Service is limited to the fees you paid to Karatology for the Service in the 3 months before the event that gave rise to the claim.
Some places do not allow certain warranties or liabilities to be excluded or limited, so some of these limits may not apply to you. Nothing in these Terms limits rights you have under laws that cannot be waived.
13. Changes to these terms
We may update these Terms from time to time. The date at the top of this page shows when they last changed. For material changes, we will give reasonable advance notice by email to the address on your account or in your dashboard. If you keep using the Service after a change takes effect, you accept the updated Terms. If you do not agree, stop using the Service and cancel your plan.
14. General
- If you have a separate written agreement signed by Karatology, that agreement controls where it conflicts with these Terms.
- If any part of these Terms is found unenforceable, the rest remains in effect. If we do not enforce a part of these Terms, that is not a waiver of our right to do so later.
- You may not transfer your account or these Terms without our consent. We may transfer them as part of a merger, acquisition or sale of the Service.
- These Terms are governed by the laws that apply where Karatology is established, except where the law where you live requires otherwise.
15. Contact
Questions about these Terms, your account or your bill? Email contact@karatology.com. Please include the X-Request-Id from any response you are asking about.