# Visokio services for AI agents

> Pay per use in USDC (x402), no account and no API key. Each service below answers in one reply, with a link a
> person can open to check how the answer was reached.

Exact requests and replies, machine-readable: https://agents.dev.visokio.com/openapi.json.

Test site: payments here are test USDC on Base Sepolia, not real money.

How to pay (x402 version 2): call the buy address with `POST`. The `402` reply carries the price and where to pay
in its `PAYMENT-REQUIRED` header. Send the same call again with your signed payment in the `PAYMENT-SIGNATURE`
header. The `200` reply carries the pass, and the settlement in its `PAYMENT-RESPONSE` header. A `503` means the
service is not answering right now: no pass is sold and nothing is charged; try again after `Retry-After` seconds.
Every error reply is JSON with `error` (a code), `detail` (what went wrong) and `next` (what to do now).

The receipt (`receiptUrl` in the `200` reply) is a page for your user. To read it yourself, send `GET` to it without
the part from `#` on, with the header `Authorization: PassView <key>` (`<key>` is the text after `#k=`): the reply is
the receipt as JSON (amount, network, transaction and its explorer link, expiry). It never carries the pass.

## Insight Explorer

Send a CSV and a question; get the answer, and a report a person can open to see how it was reached.

- One question: 0.50 USDC, lasts 24 hours. POST https://agents.dev.visokio.com/buy/insight-explorer/question

1. `POST https://agents.dev.visokio.com/buy/insight-explorer/question` with `{}` and pay the 402: 0.50 USDC non-refundable (the 402 names the network). You get `pass`, `expiresAt`, `serviceUrl` (https://omniscope-service.dev.visokio.com/_service_/v1/insight-explorer/) and `receiptUrl`.
2. `POST` the service URL with header `Authorization: Bearer <pass>` and the body as multipart/form-data (RFC 7578): one part named file per CSV file (with a filename ending in .csv, Content-Type text/csv), and one part named question. For example: `curl -X POST "https://omniscope-service.dev.visokio.com/_service_/v1/insight-explorer/" -H "Authorization: Bearer <pass>" -F "file=@sales.csv;type=text/csv" -F "question=Which region sells most?"`. You get 202 and a status URL.
3. Poll the status URL with the same pass until `ready`.
4. Use the answer; give your user `reportUrl`, `username` and `password` to check it, and `receiptUrl`, the payment confirmation. Everything is kept 24 hours.