Skip to content
OpenRelay is in early access, and the /v1 API is stable. New capabilities ship in the changelog.
API ReferenceInferenceBatches

Get the Batch API's current limits

Returns the limits a batch submission runs against today: the per-batch minimum fee and the metadata caps that create and update both enforce. The minimum fee is 0 when none is configured. orl estimate and orl batches create read this instead of assuming fixed constants, so a limit change on the server reaches them without a CLI release.

Required permission

Requires the batch.read permission. See Permissions for the roles and API key permissions that include it.

Command line

The orl CLI wraps this endpoint:

orl batches limit get
GET
/v1/batches/limits

Authorization

apiKey
headerAuthorizationBearer <token>

OpenRelay API key. Send it as Authorization: Bearer or_… (legacy vl_… keys still work).

Response Body

OK

application/json
  1. response

Batch API limits that affect what a submission or an estimate should assume.

min_fee_nano_usd*integer

The per-batch minimum charge, in nanoUSD. 0 when no minimum fee is configured.

Formatint64
metadata*

The metadata caps the batch metadata update also enforces.

Example Request
curl -X GET 'https://inference.openrelay.inc/v1/batches/limits'
Example Response
{  "min_fee_nano_usd": 0,  "metadata": {    "max_pairs": 0,    "max_key_length": 0,    "max_value_length": 0  }}