> For the complete documentation index, see [llms.txt](https://docs.starfall.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.starfall.ai/api-usage.md).

# API Usage

## Limits

Currently, Starfall is offering our platform for free for the first 50 wallets lookups to every verified user. We are committed to extending our platform for free up to a limited amount of requests (subject to change) to every business through Q2 2024.

If you business has a need for more free requests, please feel free to reach out to us at <team@starfall.ai>

## Rate limiting

Starfall rate limits users in the free tier and this can be increased for business users.&#x20;

Please reach out to the Starfall team at <team@starfall.ai> if you'd like to integrate at a higher rate limit.

## Subscriptions

We are currently working on a subscription model for our business users. As mentioned above we are committed to offering the platform for free through Q2 2024. Reach out to us for more information.

## Model versioning

Starfall uses custom machine learning models to make predictions about every wallet using on and off chain data. Currently, all of our models run on the latest version of our data as of November 2023.

We plan to include headers that specify the model version being used in our API through a `X-Model-Version` header and by passing this variable through a query parameter in the request.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.starfall.ai/api-usage.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
