{"id":15774191,"url":"https://github.com/iaincollins/ardent-api","last_synced_at":"2025-10-08T09:05:47.519Z","repository":{"id":173583828,"uuid":"650958211","full_name":"iaincollins/ardent-api","owner":"iaincollins","description":"Ardent API provides access to data submitted to Elite Dangerous Data Network","archived":false,"fork":false,"pushed_at":"2025-06-02T23:18:55.000Z","size":430,"stargazers_count":11,"open_issues_count":3,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-10-08T09:02:13.477Z","etag":null,"topics":["eddn","elite-dangerous","elitedangerous"],"latest_commit_sha":null,"homepage":"https://ardent-insight.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iaincollins.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-06-08T07:19:07.000Z","updated_at":"2025-09-08T14:53:53.000Z","dependencies_parsed_at":"2024-01-18T15:22:21.855Z","dependency_job_id":"e9a8150d-fd85-4087-a10e-5824c76698f2","html_url":"https://github.com/iaincollins/ardent-api","commit_stats":null,"previous_names":["iaincollins/ardent-api"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/iaincollins/ardent-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iaincollins%2Fardent-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iaincollins%2Fardent-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iaincollins%2Fardent-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iaincollins%2Fardent-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iaincollins","download_url":"https://codeload.github.com/iaincollins/ardent-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iaincollins%2Fardent-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278916700,"owners_count":26068156,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["eddn","elite-dangerous","elitedangerous"],"created_at":"2024-10-04T16:20:27.267Z","updated_at":"2025-10-08T09:05:47.487Z","avatar_url":"https://github.com/iaincollins.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ardent API\n\nThe Ardent API powers [ardent-insight.com](https://ardent-insight.com)\n\nThe API is considered resonably stable and no breaking changes are anticipated,\nbut expect evolution of parameters that can be passed and enrichment of\nresponses. \n\nThe internal logic for routes may evolve over time and this may cause the \ncontent of responses to vary, based on changes to internal filters, how data \nis processed and changes in retention policies. \n\nRelated repositories:\n\n* https://github.com/iaincollins/ardent-www\n* https://github.com/iaincollins/ardent-collector\n* https://github.com/iaincollins/ardent-auth\n\n## About this software\n\nThe Ardent API provides access to data submitted to the Elite Dangerous Data \nNetwork and is stored by the \n[Ardent Collector](https://github.com/iaincollins/ardent-collector/).\n\nThe API provides an interface to look up location data for 150,000,000 star systems \nand tracks millions of buy and sell orders for trade commodities sold in stations,\nports and on fleet carriers throughout the Elite Dangerous galaxy.\n\n## About the REST API\n\nThe folllowing is a summary of supported API endpoints and a description of \nthe behaviour and options supported.\n\n* The endpoints are versioned but there may still be changes in the logic of how \nrequests are handled and exactly what data returned in response to a query as \nfunctionality is expanded on and refined. For example, what results are filtered\nout, or not filterd out, by default may change, but any changes to requests or \nresponses should typically be additive rather than be breaking changes.\n\n* The `fleetCarriers` boolean option supported on some of the endpoints is `null` \nby default. If set to `true` or `1` the response will only include results for \nfleet carriers, if set to `false` or `0`  the response will exclude results for \nfleet carriers. If not specified, or set to any other value, the response will \ninclude results for all stations (including from, but not limited to, fleet \ncarriers).\n\n* The `maxDistance` option is light-years (`ly`) and is used to filter results \nfrom other systems based on the distance of that systems main star from the \nmain star of the system the result is relative to. You cannot specify a \nfractional value in light seconds (`ls`) to filter results within a system; \nalthough the approximate distance to the main star for each station is \ndisplayed (when known) it is not taken into account.\n\n* As of version `3.0.0` of the code the commodity `import` and `export` endpoints \nsupport a `maxDaysAgo` option that defaults to `30` days. This filters out data \nolder than 30 days from results by default, which makes results more relevant \nand improves response times. You can still request to include older data by \nexplicitly specifying a greater value. Records are updated when newer \ninformation is submitted.\n\n* The API examples below show using system name but in addition to system name\nyou can query by system address. Using the System Address allows for disambiguation\nin cases where there is more than one system with the same name. \n\nFor example, the following queries are equivalent:\n\n* https://api.ardent-insight.com/v2/system/name/Sol\n* https://api.ardent-insight.com/v2/system/address/10477373803\n\nAs are these requests:\n\n* https://api.ardent-insight.com/v2/system/name/Sol/stations\n* https://api.ardent-insight.com/v2/system/address/10477373803/stations\n\nThere are over 1,300 known ambigiously named systems in the database, out of \napproximately 150,000,000 recorded systems.\n\nThe service provides a hint when querying if there is known to be another system \nwith a similar name.\n\nExamples of queries for ambigiously named systems:\n\n* https://api.ardent-insight.com/v2/system/name/C%20Velorum\n* https://api.ardent-insight.com/v2/system/name/i%20Carinae\n* https://api.ardent-insight.com/v2/system/name/I%20Carinae\n* https://api.ardent-insight.com/v2/system/address/5533856349\n* https://api.ardent-insight.com/v2/search/system/name/C%20Vel\n\n## REST API Endpoints\n\n### Get version\n\nGet Ardent API software version.\n\n* https://api.ardent-insight.com/v2/version\n\n### Get statistics\n\nGet statistics for the current databases (updated every 15 minutes).\n\n* https://api.ardent-insight.com/v2/stats\n\n```\n    Star systems: 102,694,411\n    Trade systems: 16,419\n    Trade stations: 42,695\n    Trade carriers: 5,360\n    Trade orders: 10,773,236\n    Trade updates in last 24 hours: 563,215\n    Trade updates in last 7 days: 2,475,140\n    Trade updates in last 30 days: 7,234,476\n```\n\nAdditional stats endpoints for data related to stations:\n\n* https://api.ardent-industry.com/v2/stats/stations/economies\n* https://api.ardent-industry.com/v2/stats/stations/types\n\n### Get commodities reports\n\nThe Commodities report includes all known traded commodities, their price\nranges (min/max/avg) and the total supply and demand for each commodity.\n\nThe commodity report excludes market data from Fleet Carriers.\n\nIt is updated daily.\n\n* https://api.ardent-insight.com/v2/commodities\n\n#### Example commodities report\n\n    [ ... {\n      \"commodityName\": \"gold\",\n      \"maxBuyPrice\": 59797,\n      \"minBuyPrice\": 3979,\n      \"avgBuyPrice\": 44441,\n      \"totalStock\": 73016533,\n      \"maxSellPrice\": 70761,\n      \"minSellPrice\": 3978,\n      \"avgSellPrice\": 48259,\n      \"totalDemand\": 1899662825\n    } ... ]\n\n### Commodity information\n\n#### Get information for a commodity\n\nGet summary report for a commodity.\n\n* https://api.ardent-insight.com/v2/commodity/name/{commodityName}\n\ne.g. https://api.ardent-insight.com/v2/commodity/name/gold\n\n#### Get importers for a commodity\n\nGet a list of places importing a commodity - places you can sell to - ordered \nby the highest price they are willing to pay. Returns best 100 matching results.\n\n* https://api.ardent-insight.com/v2/commodity/name/{commodityName}/imports\n\ne.g. https://api.ardent-insight.com/v2/commodity/name/gold/imports\n\n##### Supported query parameters\n\n* minVolume (int); default 1\n* minPrice (int); default 1\n* fleetCarriers (bool); default null\n* maxDaysAgo (int); default 30\n\n#### Get exporters for a commodity\n\nGet a list of exports of a commodity - places where you can buy from - ordered \nby the lowest price you can buy it for. Returns best 100 matching results.\n\n* https://api.ardent-insight.com/v2/commodity/name/{commodityName}/exports\n\ne.g. https://api.ardent-insight.com/v2/commodity/name/gold/exports\n\n##### Supported query parameters\n\n * minVolume (int); default 1\n * maxPrice (int); default null\n * fleetCarriers (bool); default null\n * maxDaysAgo (int); default 30\n\n### System information\n\n#### Get information for a system \n\nGet information about a system.\n\n* https://api.ardent-insight.com/v2/system/name/{systemName}\n\ne.g. https://api.ardent-insight.com/v2/system/name/Sol\n\n#### Get a list of nearby systems\n\nReturns a list of up to 1000 nearby systems, ordered by distance.\n\n* https://api.ardent-insight.com/v2/system/name/{systemName}/nearby\n\ne.g. https://api.ardent-insight.com/v2/system/name/Sol/nearby\n\n##### Supported query parameters\n\n* maxDistance (int); default 100, max 500\n\n#### Get nearest station service\n\nFind the nearest station providing a specific type of service and information \nabout the station and system they are in.\n\nThe location of 20 nearest matching stations will be returned. Results are \nreturned in order of distance. A minimum landing pad size for the station can \nbe specified.\n\n* https://api.ardent-insight.com/v2/system/name/{systemName}/nearest/{service}\n\ne.g. You can query for any of these services:\n\n* https://api.ardent-insight.com/v2/system/name/Sol/nearest/interstellar-factors\n* https://api.ardent-insight.com/v2/system/name/Sol/nearest/material-trader\n* https://api.ardent-insight.com/v2/system/name/Sol/nearest/technology-broker\n* https://api.ardent-insight.com/v2/system/name/Sol/nearest/black-market\n* https://api.ardent-insight.com/v2/system/name/Sol/nearest/universal-cartographics\n* https://api.ardent-insight.com/v2/system/name/Sol/nearest/refuel\n* https://api.ardent-insight.com/v2/system/name/Sol/nearest/repair\n* https://api.ardent-insight.com/v2/system/name/Sol/nearest/shipyard\n* https://api.ardent-insight.com/v2/system/name/Sol/nearest/outfitting\n* https://api.ardent-insight.com/v2/system/name/Sol/nearest/search-and-rescue\n\n##### Supported query parameters\n\n* minLandingPadSize (int); default 1 (1 = small, 2 = medium, 3 = large)\n\n#### Get commodities traded in a system\n\nReturns a list of all known trade orders in a system.\n\n* https://api.ardent-insight.com/v2/system/name/{systemName}/commodities\n\ne.g. https://api.ardent-insight.com/v2/system/name/Sol/commodities\n\n#### Get commodities imported by a system\n\nReturns a list of all known commodities imported by a system - places where you \ncan sell to - ordered by name of the commodity.\n\n* https://api.ardent-insight.com/v2/system/name/{systemName}/commodities/imports\n\ne.g. https://api.ardent-insight.com/v2/system/name/Sol/commodities/imports\n\n##### Supported query parameters\n\n* minVolume (int); default 1\n* minPrice (int); default 1\n* fleetCarriers (bool); default null\n* maxDaysAgo (int); default 30\n\n#### Get commodities exported by a system\n\nReturns a list of all known commodities exported by a system - places where you \ncan buy from - ordered by name of the commodity.\n\n* https://api.ardent-insight.com/v2/system/name/{systemName}/commodities/exports\n\ne.g. https://api.ardent-insight.com/v2/system/name/Sol/commodities/exports\n\n##### Supported query parameters\n\n* minVolume (int); default 1\n* maxPrice (int); default null\n* fleetCarriers (bool); default null\n* maxDaysAgo (int); default 30\n\n#### Get trade data for a commodity in a system\n\nGet all buy/sell orders for a commodity in a system.\n\n* https://api.ardent-insight.com/v2/system/name/{systemName}/commodity/name/{commodityName}\n\ne.g. https://api.ardent-insight.com/v2/system/name/Sol/commodity/name/gold\n\n##### Supported query parameters\n\n* maxDaysAgo (int); default 30\n\n#### Get a list of nearby importers of a commodity\n\nGet a list of nearby places that importing a commodity close to the specified \nsystem. Returns the first 1000 results, ordered by the highest price they are \nwilling to pay.\n\n* https://api.ardent-insight.com/v2/system/name/{systemName}/commodity/name/{commodityName}/nearby/imports\n\ne.g. https://api.ardent-insight.com/v2/system/name/Sol/commodity/name/gold/nearby/imports\n\n##### Supported query parameters\n\n* minVolume (int); default 1\n* minPrice (int); default 1\n* fleetCarriers (bool); default null\n* maxDistance (int); default 100, max 500\n* maxDaysAgo (int); default 30\n\n#### Get a list of nearby exporters of a commodity\n\nGet a list of nearby places that importing a commodity close to the specified \nsystem. Returns the first 1000 results, ordered by the lowest price you can buy\nit for.\n\n* https://api.ardent-insight.com/v2/system/name/{systemName}/commodity/name/{commodityName}/nearby/exports\n\ne.g. https://api.ardent-insight.com/v2/system/name/Sol/commodity/name/gold/nearby/exports\n\n##### Supported query parameters\n\n* minVolume (int); default 1\n* maxPrice (int); default null\n* fleetCarriers (bool); default null\n* maxDistance (int); default 100, max 500\n* maxDaysAgo (int); default 30\n\n#### Get trade data for a commodity in a specific market\n\nGet information about commodity for a specific market.\n\nThis was added to support providing information about rare goods, which are \ntypically only avalible from a single known market\n\nSupport for additional queries by market ID may be added in future.\n\n* https://api.ardent-insight.com/v2/market/{marketId}/commodity/name/{commodityName}\n\ne.g. https://api.ardent-insight.com/v2/market/128106744/commodity/name/lavianbrandy\n\n## Authentication\n\nAll of the routes handled by this API are anonymous.\n\nThe [Authentication Service](https://github.com/iaincollins/ardent-auth) for \nArdent handles calls to all API routes that involve authentication.\n\n## Rate Limits\n\nThe service does not currently enforce any rate limits.\n\nIt is intended to be performant under load but respectful use is appreciated.\n\nFor those who want to perform a very high number of queries, the entire stack \nis open source and can be cloned and run locally.\n\nFull database dumps can be downloaded from https://ardent-insight.com/downloads\n\n## Credits\n\n_This software would not be possible without work from dozens of enthusiasts \nand hundreds of open source contributors._\n\nSpecial thanks to Elite Dangerous Community Developers members, Elite \nDangerous Data Network maintainers, Anthor (Elite Dangerous Star Map) \nand Gareth Harper (Spansh).\n\nThank you to all those who have created and supported libraries on which this \nsoftware depends and to Frontier Developments plc for supporting third party \ntools.\n\n## Legal\n\nCopyright Iain Collins, 2024.\n\nThis software has been released under the GNU Affero General Public License.\n\nElite Dangerous is copyright Frontier Developments plc. This software is \nnot endorsed by nor reflects the views or opinions of Frontier Developments and \nno employee of Frontier Developments was involved in the making of it.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiaincollins%2Fardent-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiaincollins%2Fardent-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiaincollins%2Fardent-api/lists"}