Credits and pricing

Credits are prepaid. 1 credit = 1 CAD cent. Every API has a fixed price per successful call, shown as priceCents in the catalog. Most calls cost 1 to 10 credits.

What you are charged for

Situation	Charged?
The API returns 200 with a result	Yes, its `priceCents`
Bad input (400 `invalid_input`), unknown API (404)	No: input is checked before any charge
The upstream provider fails (502/503)	No: the debit happens only after a result exists
Not enough credits (402 `insufficient_credits`)	No
A retry with the same `Idempotency-Key`	No: you get the original charge back as `replay: true`
Chat	Real token cost, held up front and settled down to what was used

Check your balance

bash

curl -s https://api.highlnd-intel.group/v1/account -H "authorization: Bearer $HIGHLAND_KEY"

json

{
  "accountId": "acct_3f9c…",
  "balanceCents": 1320,
  "plan": { "id": "solo", "active": true, "periodEnd": "2026-11-22T14:05:00.000Z" }
}

Every paid response also returns your new balanceCents, so you rarely need a separate call.

Safe retries with Idempotency-Key

Networks drop. If you retry a paid call without a key, you may pay twice. Send a unique Idempotency-Key (8 to 64 characters: letters, digits, _, -) and reuse it on retries:

bash

curl -s https://api.highlnd-intel.group/v1/api/hash \
  -H "authorization: Bearer $HIGHLAND_KEY" \
  -H "idempotency-key: job-42-item-7" \
  -H "content-type: application/json" \
  -d '{"text":"hello"}'

python: retry with backoff, charged once

import os, time, uuid, requests

def call(api, body, attempts=4):
    key = str(uuid.uuid4())  # one key per logical call, reused on every retry
    for i in range(attempts):
        try:
            r = requests.post(
                f"https://api.highlnd-intel.group/v1/api/{api}",
                headers={"authorization": f"Bearer {os.environ['HIGHLAND_KEY']}", "idempotency-key": key},
                json=body, timeout=30,
            )
            if r.status_code < 500 and r.status_code != 429:
                return r.json()
        except requests.RequestException:
            pass
        time.sleep(2 ** i)
    raise RuntimeError("gave up")

A replayed call returns "replay": true and costs nothing extra.

Ways to add credits

Method	Best for	Guide
USDC top-up ($1 to $1000)	Anyone with a crypto wallet or exchange account	Buy credits
Monthly plan (Solo $9, Builder $19)	Regular use, with 10 to 20% bonus credits	Plans
Coupon code	Trials and promotions	Coupons
Referral reward	Sharing your link	Referrals
x402 per call	Agents without an account	x402

Currency and FX

Prices are in CAD cents. USDC is in US dollars. Top-ups convert at a fixed rate (currently 0.75 USD per CAD, so $10 buys 1333 credits), always rounded down so you are never over-credited. x402 prices use the same rate: a 2-credit API costs 0.015 USDC.

Limits

Limit	Value
Request body	64 KB
Top-up	$1 to $1000 per intent
Open top-up intents	10 per account
Keys per password account	20
Chat `max_tokens`	1 to 2048 (default 512)

Credits and pricing

#What you are charged for

#Check your balance

#Safe retries with Idempotency-Key

#Ways to add credits

#Currency and FX

#Limits