Market data API

REST over HTTPS, JSON responses. Today it covers Robinhood Chain; more chains are coming, at the same price.

Base URL

https://data.lucrios.finance

Authentication

Send your key in the x-api-key header on every request. Keys come from your account and open with the plans; each key is shown once, so store it where your code reads secrets.

curl -H "x-api-key: $LUCRIOS_API_KEY" \
  "https://data.lucrios.finance/pools?sort=volume&per_page=5"

A wrong key gets 401, even from a browser. Never put a key in front-end code.

Limits and errors

Each plan has a per-minute and a daily limit (see plans). Errors come as JSON with a code and a message.

Status	Meaning
`400`	A parameter is invalid. The message says which and what it accepts.
`401`	No key, or the key is wrong or revoked.
`403`	The route is not in your plan.
`404`	No such pool, token or wallet.
`429`	Over the limit. Wait and retry.

Conventions

Addresses are lowercase hex. Times are Unix seconds in parameters and RFC 3339 in responses.
verdict.status in a check is high_risk (a danger finding), caution (a warn) or no_flags. Each finding has a level: danger, warn, unknown (not read yet) or ok.
Lists page with page and per_page, and sort with sort and order (asc or desc).
Dollar values are strings with the full precision, so they never lose digits in JavaScript.

See every endpoint →