---
title: "Lookup Fee Schedules"
method: POST
path: "/v1/fees/schedules/lookup"
tags: ["fees"]
---

# Lookup Fee Schedules

`POST /v1/fees/schedules/lookup`

Return normalized exchange fee schedules for up to 1,000 instruments.

Coefficients are decimal strings so clients can reproduce venue rounding
without first losing precision through a JSON floating-point value.

## Request body

- FeeScheduleLookupRequest
  - `river_ids` integer[], required — River IDs whose exchange fee schedules should be returned.

## Response `200`

Successful Response

- FeeScheduleLookupResponse
  - `schedules` FeeScheduleResponse[], required
    - `river_id` integer, required
    - `exchange` string, required
    - `model` 'price_shape_v1', required — Formula applied before a fee rule's rounding step. ``PRICE_SHAPE_V1`` computes ``quantity * coefficient * price * (1 - price)``.
    - `maker` FeeRuleResponse, required
      - `coefficient` string, required — Decimal multiplier in fee = quantity × coefficient × price × (1 - price).
      - `rounding` 'none' | 'ceil_cent' | 'half_even_cent', required
      - `pre_ceiling_cent_decimals` integer, nullable, required — Decimal places used to stabilize fee × 100 before applying ceil_cent.
    - `taker` FeeRuleResponse, required
      - `coefficient` string, required — Decimal multiplier in fee = quantity × coefficient × price × (1 - price).
      - `rounding` 'none' | 'ceil_cent' | 'half_even_cent', required
      - `pre_ceiling_cent_decimals` integer, nullable, required — Decimal places used to stabilize fee × 100 before applying ceil_cent.
    - `schedule_version` string, required — Stable fingerprint of the normalized schedule.
  - `missing_river_ids` integer[], required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/rivermarkets/apis/river-finance-api.md) · [All operations](https://skmtc.net/rivermarkets/apis/river-finance-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rivermarkets/river-finance-api/revisions/3776a0431319/schema)