StalkChain Data
Tool reference

Account & status

Data source health (keyless)

stalkchain_health · free

Ask: "Is the data service up?"

Is the API up or down. Liveness, loaded trader count and uptime, plus the state of every data source behind the tools (ok, degraded, or down with when to retry). Use when a call just failed and you need to say whether the service is down or the request was wrong. Free, no key needed, 0 credits.

No inputs.

REST: POST /api/v1/tools/stalkchain_health with the inputs as a JSON body, or GET /api/v1/tools/stalkchain_health?….

the provider account & credit balance

stalkchain_account · free

Ask: "How many credits does this key have left?"

How many credits do I have left. The account behind the active key: plan, credits remaining, monthly allowance, how much is used this month, prepaid top-ups, expiry. Use when asked about the balance, quota, plan, how many calls are left, or before starting an expensive workflow. For what this conversation alone has spent, use stalkchain_usage. Costs 0 credits.

No inputs.

REST: POST /api/v1/tools/stalkchain_account with the inputs as a JSON body, or GET /api/v1/tools/stalkchain_account?….

Session credit usage & key pool

stalkchain_usage · free

Ask: "How much have we spent in this session and is the cache helping?"

What has this session cost so far. A local ledger with no API call: credits spent in this conversation, which tools were hit, cache hit rate, keys exhausted or invalid, and the documented price table. Use when asked what something cost, how much has been used up, or to budget the rest of the work. For the ACCOUNT balance rather than this session, use stalkchain_account. Costs 0 credits.

InputTypeRequiredDescription
clearCachebooleannoAlso clear the in-memory response cache

REST: POST /api/v1/tools/stalkchain_usage with the inputs as a JSON body, or GET /api/v1/tools/stalkchain_usage?….

Last modified on