Authenticate API requests to OnyxIQ

OnyxIQ uses session-based authentication. There is no separate API key system — every request is authenticated using the session cookie set when you sign in at onyxiq.in/login.

How it works

When you sign in at onyxiq.in/login, a session cookie named sb-[project-ref]-auth-token is set in your browser. The API reads this cookie on every request to verify your identity and check your credit balance. In the browser, the cookie is attached automatically to same-origin requests — no extra steps required. In cURL or scripts, you must copy the cookie value from your browser and pass it with each request.

Go to onyxiq.in/login and complete sign-in.

Open DevTools

Open your browser’s DevTools (F12), go to Application → Cookies, and select https://onyxiq.in.

Copy the cookie value

Find the cookie named sb-[ref]-auth-token and copy its value.

Pass it in your request

Add the cookie to your request using the -H "Cookie: ..." header (see example below).

Example request

curl -X POST https://onyxiq.in/api/openclaw/scrape \
  -H "Content-Type: application/json" \
  -H "Cookie: sb-[ref]-auth-token=[token]" \
  -d '{"url":"https://example.com"}'

Replace [ref] with the project ref in the cookie name you copied (e.g. sb-abcdefgh-auth-token) and [token] with the full cookie value.

Error responses

Status	Body	Meaning
`401`	`{"error":"Authentication required"}`	The session cookie is missing, expired, or invalid. Sign in again at onyxiq.in/login.
`402`	`{"error":"Insufficient credits...","balance":N,"required":10}`	Your account does not have enough credits. Top up at onyxiq.in/credits.

If you only need to scrape pages or use other OnyxIQ products interactively, the web UI at onyxiq.in/products is simpler than making raw API calls — no cookie handling required.

​How it works

​Getting the cookie for cURL

​Example request

​Error responses

How it works

Getting the cookie for cURL

Example request

Error responses