# Aries Solver

> A reCAPTCHA v3 solving API. One HTTP request returns a valid token together with the browser fingerprint that produced it. Billing is one credit per successfully solved token; failed solves are never charged.

Base URL: https://aries-solver.info
Authentication: send `X-API-Key: ar_live_...` on every request. `Authorization: Bearer ar_live_...` and a `clientKey` body field are also accepted.
Pricing: $2 per 1000 solves ($0.002 each). Credits never expire.
Getting a key: keys are issued by hand. There is no sign-up. Buy credits at https://t.me/Anxioussoul.

Every endpoint exists at the root and under a `/v1` prefix; the two are identical.

## Docs

- [Full API reference](https://aries-solver.info/llms-full.txt): the complete specification in one plain-text file - parameters, response schema, every error, rate limits and worked examples. Read this one if you are generating client code.
- [HTML documentation](https://aries-solver.info/docs): the same reference rendered for people, with tabbed examples in cURL, Python, Node.js, Go and PHP.
- [Home](https://aries-solver.info/): what the service does and what it costs.

## Endpoints

- `POST https://aries-solver.info/getRecaptchaV3`: solve a reCAPTCHA v3. Required body fields: `url`, `sitekey`, `proxy`. Optional: `action`, `enterprise`, `title`. Returns `{status, data:{token, user_agent, sec_ch_ua, sec_ch_ua_platform, sec_ch_ua_mobile, accept_lang}, credits}`. Costs 1 credit on success only.
- `GET https://aries-solver.info/balance`: remaining credits. Returns `{status, credits}`. Free. `POST` also works.
- `GET https://aries-solver.info/health`: service status, no authentication. Returns `{status, service}` where status is `success` or `maintenance`.

## Notes for code generation

- The response envelope is always `{"status": "success"|"error", ...}`. On error the body is `{"status":"error","message":"..."}` and the HTTP status carries the meaning.
- `proxy` is mandatory and must include a scheme and a port: `scheme://user:pass@host:port`, where scheme is `http`, `https`, `socks4` or `socks5`.
- Send the returned `user_agent`, `sec_ch_ua`, `sec_ch_ua_platform`, `sec_ch_ua_mobile` and `accept_lang` as headers on the request where you use the token, and use the same proxy. The token is bound to that fingerprint.
- Tokens expire in roughly two minutes. Solve at the point of use rather than pooling ahead of time.
- Retry `429`, `500` and `503` with exponential backoff. Never retry `400` or `401` unchanged - fix the request. `402` means the balance is empty.
- Allow a client timeout of at least 180 seconds; a solve can take a while under load.
- Read the `credits` field of each solve response to track balance instead of polling `/balance`.

## Optional

- [Telegram](https://t.me/Anxioussoul): buy credits, request a key, ask about volume pricing or higher rate limits.