---
title: "Propose a trade"
method: POST
path: "/api/v1/proposals"
---

# Propose a trade

`POST /api/v1/proposals`

## Request

- Base URL: `https://traydstar.com`
- URL: `https://traydstar.com/api/v1/proposals`
- Auth: HTTP bearer

Scope: propose. Offer one of your listings (optional) for someone else's listing.

## Request body

- object
  - `receiver_listing_id` string, uuid, required
  - `proposer_listing_id` string, uuid
  - `message` string

## Response `201`

Proposal created.

- object
  - `proposal_id` string, uuid, required

## Other responses

- `default`: Error.

---

[API](https://skmtc.dev/traydstar/apis/traydstar-api.md) · [All operations](https://skmtc.dev/traydstar/apis/traydstar-api/llms.txt) · [OpenAPI document](https://skmtc.dev/traydstar/apis/traydstar-api/revisions/641f54d9786b?raw)