Nexus/API Reference/Ports

Make a port

POSThttps://app.skylit.ai/api/nexus/v1/trading/ports

A new extra port with its own wallet at startingCash. Up to 5 ports in all, Main and Bot included.

A create takes no clientOrderId. A retry after the first one worked answers 409 name_taken: list your ports and find it by name. It counts as a write.

Authorization

Authorization: Bearer <your API key>

Required. A missing header returns 401; an invalid, revoked or expired key returns 403.

Request body

  • namestringrequired
  • startingCashnumberrequired
    100002500050000100000250000

Responses

  • 201

    The new port.

  • 400

    The request was refused and nothing changed. Codes: bad_request (an unknown field or a body that isn't JSON), bad_name (1 to 32 characters, no control characters), bad_starting_cash (missing, or not one of limits.startingCashChoices).

  • 401

    No key, or a key that isn't valid. Codes: missing_api_key, invalid_api_key.

  • 403

    The key works but this can't be done. Codes: feature_disabled (ports are switched off on the server: leave port out), account_suspended, nexus_access_denied.

  • 409

    Codes: port_limit (you already have 5 ports: delete one first), name_taken (a live port of yours already has that name, whatever the capitals; a retried create lands here too).

  • 429

    Over a rate limit. Wait Retry-After seconds, then retry. Codes: rate_limited, and stream_limit_reached (too many live streams open: 3 per key, 6 per account).

  • 500

    Something went wrong on our side. If you sent a clientOrderId, retry with the same one. Code: internal_error.

Response fields

  • dataobject
    • portobject

      One of your ports. Money is in dollars.

Last updated

Was this page helpful?