Quickstart - Symbiosis

Create an account

curl -X POST https://api.symbiosis.markets/auth/signup \
  -H 'Content-Type: application/json' \
  -d '{"email": "you@example.com", "password": "a-strong-password"}'

curl -X POST https://api.symbiosis.markets/auth/login \
  -H 'Content-Type: application/json' \
  -d '{"email": "you@example.com", "password": "a-strong-password"}'

Keep the returned token; the remaining steps send it as a bearer token.

Mint an API key (for programmatic trading)

curl -X POST https://api.symbiosis.markets/auth/api-keys \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"label": "trading-bot", "scopes": ["read", "trade"]}'

The secret in the response is shown once. Programmatic requests sign with it — see Authentication and Auth.

Get a deposit address and fund it

curl -X POST https://api.symbiosis.markets/custody/create-deposit-address \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"chain": "Polygon"}'

Deposits are credited after confirmation; check with GET /custody/get-usdc-balance.

Request a quote

curl -X POST https://api.symbiosis.markets/rfq/request \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "asset_id": "0x...",
    "venue_id": "polymarket",
    "amount": "1000000",
    "side": "Bid"
  }'

Amounts are scaled by 1e6, so 1000000 is one unit. Market makers quote the request; poll GET /rfq/quote?request_id=... or subscribe to the RFQ websocket, then accept with POST /rfq/accept — see RFQ.

⌘I