Trading Quickstart

This page describes the supported openfish.me trading model: Bridge deposits, CLOB orders, and ledger balances.

1. Get A Market And Outcome ID

Use the Browse API for app-ready market cards:

curl "https://api.openfish.me/browse/markets?status=LIVE&limit=5"

Each market includes outcome data used by the frontend. Use the outcome/token identifier returned by the API when constructing orders.

For localized text:

curl "https://api.openfish.me/browse/markets?status=LIVE&locale=ja&limit=5"

2. Fund The Openfish Ledger

Deposit the supported BSC platform meme token through the Bridge:

curl -X POST "https://bridge.openfish.me/deposits" \
  -H "Content-Type: application/json" \
  -d '{"userAddress":"0xYourWalletAddress"}'

Send only the supported platform meme ERC-20 on BSC to the returned deposit address. After confirmation, the Bridge credits your Openfish ledger balance.

3. Authenticate

Authenticated trading requests use the CLOB API:

https://api.openfish.me

Openfish uses:

L1 wallet signature to derive API credentials.
L2 HMAC credentials for trading requests.

If you are using the SDK, keep the base URL pointed at https://api.openfish.me. If you call REST directly, sign requests according to the authentication docs and include the required Openfish headers.

4. Submit An Order

An order references a market outcome identifier, price, size, side, expiration, and signature data. The server validates available ledger balance before accepting the order.

High-level flow:

Build order payload.
Sign order.
Send POST /order with L2 headers.
Read response status.

Possible statuses include:

Status	Meaning
`live`	Remainder is resting on the book.
`matched`	Order filled immediately.
`delayed`	Order is temporarily delayed by matching configuration.
`cancelled`	Order was cancelled or expired.

5. Monitor And Cancel

Common private endpoints:

Task	Endpoint
Submit order	`POST /order`
Submit batch orders	`POST /orders`
Cancel one order	`DELETE /order`
Cancel multiple orders	`DELETE /orders`
Cancel all orders	`DELETE /cancel-all`
List own orders	`GET /data/orders`
List own trades	`GET /data/trades`

Use the WebSocket user channel for fill and order status updates when available.

6. Withdraw

When you want to leave the platform, request a BSC platform meme withdrawal:

curl -X POST "https://bridge.openfish.me/withdrawals" \
  -H "Content-Type: application/json" \
  -d '{
    "userAddress": "0xYourWalletAddress",
    "toAddress": "0xDestinationBscAddress",
    "amount": "10",
    "toChainId": "56",
    "tokenAddress": "0xaE71fd8baCc2f17C43a01C3F4aFF6dEEbc194444"
  }'

Use /supported-assets to confirm the current token address before integrating.

Troubleshooting

Problem	Likely cause
Insufficient balance	Your Openfish ledger balance is too low or already reserved by open orders.
Invalid signature	L1/L2 authentication headers do not match the wallet or API credentials.
Invalid tick size	Price does not align with the market’s allowed increment.
Unsupported bridge asset	Deposit or withdrawal token is not the configured BSC platform meme ERC-20.