---
title: "Read-only SQL"
method: POST
path: "/v1/sql"
---

# Read-only SQL

`POST /v1/sql`

## Request

- Base URL: `https://api.onvexia.com`
- URL: `https://api.onvexia.com/v1/sql`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in header `Authorization`
  - API key in header `X-PAYMENT`

Ad-hoc SELECT for questions the REST surface cannot express. Read-only, statement-timeout bounded, 10k-row cap, and truncation is always reported. See /v1/sql/schema for queryable relations.

## Request body

- object

## Response `200`

OK

## Other responses

- `402`: Payment required (x402): no account needed, pay per call
- `404`: Not found, or metric registered but not yet served (the body names it)

---

[API](https://skmtc.dev/onvexia/apis/onvexia-crypto-sentiment-whale-tracking-onchain-analytics-ap.md) · [All operations](https://skmtc.dev/onvexia/apis/onvexia-crypto-sentiment-whale-tracking-onchain-analytics-ap/llms.txt) · [OpenAPI document](https://skmtc.dev/onvexia/apis/onvexia-crypto-sentiment-whale-tracking-onchain-analytics-ap/revisions/7619665fc084?raw)