# List coins

> One transaction that opens an offer and locks the coins in its vault. A fixed offer is totalPriceRaw lamports for the whole amount (the site takes a market cap and divides it over the total supply). The seller pays the deposit (about 0.0046 SOL, back when it closes) and the network fee. Refused before signing with NOT_HELD when the wallet holds less than the amount.


`POST https://payday.direct/api/otc/list`

One transaction that opens an offer and locks the coins in its vault. A fixed offer is `totalPriceRaw` lamports for the whole amount (the site takes a market cap and divides it over the total supply). The seller pays the deposit (about 0.0046 SOL, back when it closes) and the network fee. Refused before signing with `NOT_HELD` when the wallet holds less than the amount.

## Body

- `wallet` (string, required): The wallet that signs and pays
- `mint` (string, required): Any pump.fun coin
- `amountRaw` (string, required): Raw units to lock
- `mode` ("fixed" | "market", required): `account` (fees to an account) or `cash_payback` (fees to holders)
- `totalPriceRaw` (string): fixed: lamports for the whole amount
- `offsetBps` (integer): market: your price against the market
- `floorTotalRaw` (string): market, optional: lamports the whole amount must never sell under
- `minFillRaw` (string): Optional smallest fill, raw units
- `expiresAt` (integer, required): Unix seconds, 10 minutes to 90 days from now
- `buyer` (string): Optional: the only wallet that may fill
- `quote` ("sol"): v1 is SOL only

```json
{
  "wallet": "SellerWa11et1111111111111111111111111111111",
  "mint": "3unDHbPUsLqQtoHgvuCsRSArnuhVjhsn11vRht5Xpump",
  "amountRaw": "1000000000000",
  "mode": "market",
  "offsetBps": -150,
  "expiresAt": 1763913600,
  "minFillRaw": "100000000000"
}
```

## Responses

- 200: OK
- 400: Refused; nothing to sign
- 429: Over the limit. Retry-After says when to try again.

```json
{
  "ok": true,
  "tx": "BASE64_UNSIGNED_V0",
  "units": 61240,
  "networkFeeLamports": 7400,
  "listing": "L1st1ngAddre55111111111111111111111111111111",
  "rentLamports": 4586640,
  "rentNote": "Comes back to you when the offer closes."
}
```

## Example

```bash
curl -X POST "https://payday.direct/api/otc/list" \
  -H "Content-Type: application/json" \
  -d '{"wallet":"SellerWa11et1111111111111111111111111111111","mint":"3unDHbPUsLqQtoHgvuCsRSArnuhVjhsn11vRht5Xpump","amountRaw":"1000000000000","mode":"market","offsetBps":-150,"expiresAt":1763913600,"minFillRaw":"100000000000"}'
```