Frequently Asked Questions

Frequently Asked Questions

Is this package free to use?

Yes, the package itself is completely free and open-source under the MIT license. However, you will need a Marketstack API key. Marketstack offers a free tier with 1,000 API requests per month.

What is the difference between free and paid Marketstack plans?

• Free Plan: HTTP only, 1,000 requests/month, end-of-day data.
• Paid Plans: HTTPS support, higher request limits, real-time intraday data, and more historical data.

For paid plans, remember to set MARKETSTACK_USE_HTTPS=true in your .env file.

Can I use this without Laravel?

Yes. While the package is optimized for Laravel, you can use the MarketstackClient class directly in any PHP 8.1+ project. See the Advanced Usage guide for more details.

How do I handle API rate limits?

The package throws a MarketstackException when rate limits are exceeded. You should implement a caching strategy to reduce API calls and consider a retry mechanism for failed requests. See the Error Handling page for more information.

Which stock exchanges are supported?

Marketstack supports over 72 global exchanges, including the NYSE, NASDAQ, LSE, and many others. You can get a full list from the Exchanges endpoint.

Can I get real-time data?

Yes, with a paid Marketstack plan. You can use the intraday() endpoint with intervals as low as 1 minute.

How do I test my application?

Use Laravel's Http::fake() to mock API responses. This allows you to test your application without making actual HTTP requests. See the Testing guide for examples.