---
title: "Structured appetite search (query + lines + state)"
method: POST
path: "/broker/appetite/search"
tags: ["Appetite"]
---

# Structured appetite search (query + lines + state)

`POST /broker/appetite/search`

## Request

- Base URL: `https://api.hedgespecialty.com/api/v1`
- URL: `https://api.hedgespecialty.com/api/v1/broker/appetite/search`
- Auth: OAuth 2
  - Authorization code: `https://api.hedgespecialty.com/api/v1/oauth/authorize`
  - Client credentials
  - Token URL: `https://api.hedgespecialty.com/api/v1/oauth/token`

The portal's placement search: a free-text risk description plus
optional lines and state, returning ranked markets with matched
programs and their Hedge category. Same daily limit as `GET /broker/appetite`.

## Request body

- object
  - `query` string
  - `state` string
  - `lines` string[]

## Response `200`

Ranked markets with matched programs

## Other responses

- `429`: Daily appetite-check limit reached

## Changes

- **2026-09-20** `7928528d98b2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hedgespecialty/apis/hedge-submission-api/changes/broker/appetite/search/post.md)

---

[API](https://skmtc.dev/hedgespecialty/apis/hedge-submission-api.md) - [All operations](https://skmtc.dev/hedgespecialty/apis/hedge-submission-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hedgespecialty/apis/hedge-submission-api/revisions/beefa9cdc11c?raw)