Usage Credits and Call Costs
How we calculate usage credits
Last updated
How we calculate usage credits
Last updated
Your account plan includes a monthly allowance of usage credits.
Usage credits are consumed as you make calls to our service during a calendar month and your allowance is replenished at midnight UTC at the start of the following calendar month.
Each API call to our platform incurs a cost in usage credits, detailed below.
We offer a /usage
end point by which you can query actual usage credits and call volume for your account.
Additionally, you can view usage charts by signing into your account on our .
If you exceed 100% of your usage credits, your API keys may stop functioning until such time as you upgrade your plan or until the start of the next calendar month.
Each API end point has an associated base 'cost', which may be modified by the parameters used for the call (e.g. requesting 100 Moon positions is more expensive than requesting just 10).
Additionally, for calls which generate a JSON response (excluding GeoJSON), the actual cost of the call is generally included in the response.
The following table sets out the base cost by end point, together with additional cost factors.
/version
0
/usage
3
/julian-day
0.5
/date
0.5
/delta-t
0.5
/rise-transit-set
3
Days, Bodies
/az-alt-search
5
Days, Bodies
/celestial-events
10
Bodies, Circumstances (×1.5), Overflow (×1.2)
/meteor-showers
1
Meteor Showers
/body-position
1
Bodies, Days, Interval (points per day)
/geodesic
1
Points, Elevation (×2)
/elevation
1
Points
/bounding-tiles
1
/sightline
3
Points
/lunar-libration
1
/lunar-limb
10
/solar-eclipse/catalog
1 TBC
/solar-eclipse/elements
1 TBC
/solar-eclipse/path
10 TBC
Points
/solar-eclipse/local-circumstances
20 TBC
/insolation/solar-intensity
1
/insolation/irradiance
2
Days, Interval (points per day)
/insolation/daily
3
Days, Interval (points per day)
/insolation/monthly
3
Days, Interval (points per day)
For any Radiant Drift API, you can determine the cost of a call without consuming any usage credits by appending the cost=1
query parameter to the URL.
A call for just the Sun at a single time will cost 1 usage credit
A call for Sun and Moon at a single time will cost 2 usage credits
A call for the Sun and Moon for a period of an hour with points for every minute will cost 118 credits (2 * 60)