spec.json

{
  "openapi": "3.0.1",
  "info": {
    "title": "Robinhood Crypto Trading API",
    "version": "",
    "x-logo": {
      "url": "https://cdn.robinhood.com/app_assets/crypto/logos/inherited-dimensions_RH_logo.png",
      "altText": "Robinhood Logo"
    },
    "description": "# Introduction\n\n\nWelcome to Robinhood Crypto Trading API documentation for traders and developers! The API lets you view crypto market data, access your account information, and place crypto orders programmatically.\n\nTo get started, head to your [crypto account settings](https://robinhood.com/account/crypto) on web classic to create credentials. There are two versions of the Crypto Trading API, giving you the option to place crypto orders with fee tiers (v2) or without fee tiers (v1). All read-only API actions are available on both versions. For more information about API version differences, fee tiers, and answers to common questions, visit our [Help Center](https://robinhood.com/us/en/support/articles/crypto-api). You can also view the [Fee Schedule](https://cdn.robinhood.com/assets/robinhood/legal/rhc-fee-schedule.pdf) for the latest rates.\n\nThe Robinhood Crypto Trading API is available to customers in the United States only. Use of the Robinhood Crypto Trading API is subject to the [Robinhood Crypto Customer Agreement](https://cdn.robinhood.com/assets/robinhood/legal/Robinhood%20Crypto%20Customer%20Agreement.pdf) as well as all other terms and disclosures made available on [Robinhood Crypto's about page](https://robinhood.com/us/en/about/crypto).\n\n\n# Authentication\n\nTo get started with the Robinhood Crypto Trading API, you need to create a key, signature, and headers. Authenticated requests must include all three `x-api-key`, `x-signature`, and `x-timestamp` HTTP headers.\n\n\n## Creating an API key\n\nHead to your [crypto account settings](https://robinhood.com/account/crypto) on web classic to create credentials. After creating credentials, you will receive the API key associated with the credential. You can modify, disable, and delete credentials you created at any time.\n\nYour API key will be used as the `x-api-key` header you will need to pass during authentication when calling our API endpoints. Additionally, you will need the public key generated in the [Creating a key pair](#section/Authentication/Creating-a-key-pair) section to create your API credentials.\n\n\n## Creating a key pair\n\n\n#### Below are example scripts on how to generate the public and private key pair. You'll need the public key for creating an API credential and the private key for authenticating requests. Remember to never share your private key with anyone. Robinhood will never ask you to share it with us.\n\nWe highly recommend saving your private and public keys in an encrypted format to ensure the highest level of security. Encrypting your keys will protect them from unauthorized access or theft. Avoid saving them in plain text or any easily accessible location. Instead, consider using strong encryption algorithms or tools specifically designed for key storage. Remember to choose a strong passphrase for encryption and store it separately from your keys. By taking these precautions, you can significantly reduce the risk of compromising your keys and safeguard your sensitive information.\n\n ### Python\n\nNote that you'll need to have `pynacl` installed to run the Python script. You can install them with the following pip command in your terminal.\n```console\npip install pynacl\n```\n\n```python\nimport nacl.signing\nimport base64\n\n# Generate an Ed25519 keypair\nprivate_key = nacl.signing.SigningKey.generate()\npublic_key = private_key.verify_key\n\n# Convert keys to base64 strings\nprivate_key_base64 = base64.b64encode(private_key.encode()).decode()\npublic_key_base64 = base64.b64encode(public_key.encode()).decode()\n\n# Print the keys in base64 format\nprint(\"Private Key (Base64):\")\nprint(private_key_base64)\n\nprint(\"Public Key (Base64):\")\nprint(public_key_base64)\n```\n\n\n## Headers and Signature\n\n<SecurityDefinitions />\n\n\n# Making your first API call\n\nDeveloping your own application to place trades with your Robinhood account is quick and simple. Once you've finished [authentication](https://docs.robinhood.com/crypto/trading/#section/Authentication), start here with the code you'll need to access the API and make supported API calls. These are essentially the building blocks of code for each API call, which you can easily build on based on your preferred strategies.\n\n1. Create a script file\n\n```console\nmkdir robinhood-api-trading && cd robinhood-api-trading\ntouch robinhood_api_trading.py\ntouch robinhood_api_trading_v2.py\n```\n\n2. Install PyNaCl library\n\n```console\npip install pynacl\n```\n\n3. To use v1 endpoints, copy the script below into the newly created `robinhood_api_trading.py` file. Make sure to add your API key and secret key into the `API_KEY` and `BASE64_PRIVATE_KEY` variables.\n\n```python\nimport base64\nimport datetime\nimport json\nfrom typing import Any, Dict, Optional\nimport uuid\nimport requests\nfrom nacl.signing import SigningKey\n\nAPI_KEY = \"ADD YOUR API KEY HERE\"\nBASE64_PRIVATE_KEY = \"ADD YOUR PRIVATE KEY HERE\"\n\nclass CryptoAPITrading:\n    def __init__(self):\n        self.api_key = API_KEY\n        private_key_seed = base64.b64decode(BASE64_PRIVATE_KEY)\n        self.private_key = SigningKey(private_key_seed)\n        self.base_url = \"https://trading.robinhood.com\"\n\n    @staticmethod\n    def _get_current_timestamp() -> int:\n        return int(datetime.datetime.now(tz=datetime.timezone.utc).timestamp())\n\n    @staticmethod\n    def get_query_params(key: str, *args: Optional[str]) -> str:\n        if not args:\n            return \"\"\n\n        params = []\n        for arg in args:\n            params.append(f\"{key}={arg}\")\n\n        return \"?\" + \"&\".join(params)\n\n    def make_api_request(self, method: str, path: str, body: str = \"\") -> Any:\n        timestamp = self._get_current_timestamp()\n        headers = self.get_authorization_header(method, path, body, timestamp)\n        url = self.base_url + path\n\n        try:\n            response = {}\n            if method == \"GET\":\n                response = requests.get(url, headers=headers, timeout=10)\n            elif method == \"POST\":\n                response = requests.post(url, headers=headers, json=json.loads(body), timeout=10)\n            return response.json()\n        except requests.RequestException as e:\n            print(f\"Error making API request: {e}\")\n            return None\n\n    def get_authorization_header(\n            self, method: str, path: str, body: str, timestamp: int\n    ) -> Dict[str, str]:\n        message_to_sign = f\"{self.api_key}{timestamp}{path}{method}{body}\"\n        signed = self.private_key.sign(message_to_sign.encode(\"utf-8\"))\n\n        return {\n            \"x-api-key\": self.api_key,\n            \"x-signature\": base64.b64encode(signed.signature).decode(\"utf-8\"),\n            \"x-timestamp\": str(timestamp),\n        }\n\n    def get_account(self) -> Any:\n        path = \"/api/v1/crypto/trading/accounts/\"\n        return self.make_api_request(\"GET\", path)\n\n    # The symbols argument must be formatted in trading pairs, e.g \"BTC-USD\", \"ETH-USD\". If no symbols are provided,\n    # all supported symbols will be returned\n    def get_trading_pairs(self, *symbols: Optional[str]) -> Any:\n        query_params = self.get_query_params(\"symbol\", *symbols)\n        path = f\"/api/v1/crypto/trading/trading_pairs/{query_params}\"\n        return self.make_api_request(\"GET\", path)\n\n    # The asset_codes argument must be formatted as the short form name for a crypto, e.g \"BTC\", \"ETH\". If no asset\n    # codes are provided, all crypto holdings will be returned\n    def get_holdings(self, *asset_codes: Optional[str]) -> Any:\n        query_params = self.get_query_params(\"asset_code\", *asset_codes)\n        path = f\"/api/v1/crypto/trading/holdings/{query_params}\"\n        return self.make_api_request(\"GET\", path)\n\n    # The symbols argument must be formatted in trading pairs, e.g \"BTC-USD\", \"ETH-USD\". If no symbols are provided,\n    # the best bid and ask for all supported symbols will be returned\n    def get_best_bid_ask(self, *symbols: Optional[str]) -> Any:\n        query_params = self.get_query_params(\"symbol\", *symbols)\n        path = f\"/api/v1/crypto/marketdata/best_bid_ask/{query_params}\"\n        return self.make_api_request(\"GET\", path)\n\n    # The symbol argument must be formatted in a trading pair, e.g \"BTC-USD\", \"ETH-USD\"\n    # The side argument must be \"bid\", \"ask\", or \"both\".\n    # Multiple quantities can be specified in the quantity argument, e.g. \"0.1,1,1.999\".\n    def get_estimated_price(self, symbol: str, side: str, quantity: str) -> Any:\n        path = f\"/api/v1/crypto/marketdata/estimated_price/?symbol={symbol}&side={side}&quantity={quantity}\"\n        return self.make_api_request(\"GET\", path)\n\n    def place_order(\n            self,\n            client_order_id: str,\n            side: str,\n            order_type: str,\n            symbol: str,\n            order_config: Dict[str, str],\n    ) -> Any:\n        body = {\n            \"client_order_id\": client_order_id,\n            \"side\": side,\n            \"type\": order_type,\n            \"symbol\": symbol,\n            f\"{order_type}_order_config\": order_config,\n        }\n        path = \"/api/v1/crypto/trading/orders/\"\n        return self.make_api_request(\"POST\", path, json.dumps(body))\n\n    def cancel_order(self, order_id: str) -> Any:\n        path = f\"/api/v1/crypto/trading/orders/{order_id}/cancel/\"\n        return self.make_api_request(\"POST\", path)\n\n    def get_order(self, order_id: str) -> Any:\n        path = f\"/api/v1/crypto/trading/orders/{order_id}/\"\n        return self.make_api_request(\"GET\", path)\n\n    def get_orders(self) -> Any:\n        path = \"/api/v1/crypto/trading/orders/\"\n        return self.make_api_request(\"GET\", path)\n\n\ndef main():\n    api_trading_client = CryptoAPITrading()\n    print(api_trading_client.get_account())\n\n    \"\"\"\n    BUILD YOUR TRADING STRATEGY HERE\n\n    order = api_trading_client.place_order(\n          str(uuid.uuid4()),\n          \"buy\",\n          \"market\",\n          \"BTC-USD\",\n          {\"asset_quantity\": \"0.0001\"}\n    )\n    \"\"\"\n\n\nif __name__ == \"__main__\":\n    main()\n```\n\n4. To use v2 endpoints, copy the script below into the newly created `robinhood_api_trading_v2.py` file. Make sure to add your API key and secret key into the `API_KEY` and `BASE64_PRIVATE_KEY` variables.\n\n```python\nimport base64\nimport datetime\nimport json\nfrom typing import Any, Dict, Optional\nimport uuid\nimport requests\nfrom nacl.signing import SigningKey\n\nAPI_KEY = \"ADD YOUR API KEY HERE\"\nBASE64_PRIVATE_KEY = \"ADD YOUR PRIVATE KEY HERE\"\n\n\nclass CryptoAPITradingV2:\n    def __init__(self):\n        self.api_key = API_KEY\n        private_key_seed = base64.b64decode(BASE64_PRIVATE_KEY)\n        self.private_key = SigningKey(private_key_seed)\n        self.base_url = \"https://trading.robinhood.com\"\n\n    @staticmethod\n    def _get_current_timestamp() -> int:\n        return int(datetime.datetime.now(tz=datetime.timezone.utc).timestamp())\n\n    @staticmethod\n    def get_query_params(params_dict: Dict[str, Any]) -> str:\n        \"\"\"\n        Build query parameter string from a dictionary.\n        - Single values: {\"key1\": \"value1\", \"key2\": \"value2\"}\n        - Multiple values for same key: {\"symbol\": [\"BTC-USD\", \"ETH-USD\"]}\n        \"\"\"\n        if not params_dict:\n            return \"\"\n        \n        params = []\n        for key, value in params_dict.items():\n            if value is None:\n                continue\n            if isinstance(value, list):\n                # Handle multiple values for the same key\n                for v in value:\n                    params.append(f\"{key}={v}\")\n            else:\n                params.append(f\"{key}={value}\")\n        \n        return \"?\" + \"&\".join(params) if params else \"\"\n\n    def make_api_request(self, method: str, path: str, body: str = \"\") -> Any:\n        timestamp = self._get_current_timestamp()\n        headers = self.get_authorization_header(method, path, body, timestamp)\n        url = self.base_url + path\n\n        try:\n            response = {}\n            if method == \"GET\":\n                response = requests.get(url, headers=headers, timeout=10)\n            elif method == \"POST\":\n                response = requests.post(url, headers=headers, json=json.loads(body) if body else None, timeout=10)\n\n            # Check for non-success status codes\n            if response.status_code >= 400:\n                print(f\"HTTP Error {response.status_code}: {response.reason}\")\n                try:\n                    return response.json()\n                except json.JSONDecodeError:\n                    return {\"error\": response.text or response.reason, \"status_code\": response.status_code}\n\n            return response.json()\n        except requests.RequestException as e:\n            print(f\"Error making API request: {e}\")\n            return None\n\n    def get_authorization_header(\n            self, method: str, path: str, body: str, timestamp: int\n    ) -> Dict[str, str]:\n        message_to_sign = f\"{self.api_key}{timestamp}{path}{method}{body}\"\n        signed = self.private_key.sign(message_to_sign.encode(\"utf-8\"))\n\n        return {\n            \"x-api-key\": self.api_key,\n            \"x-signature\": base64.b64encode(signed.signature).decode(\"utf-8\"),\n            \"x-timestamp\": str(timestamp),\n        }\n\n    def get_accounts(self) -> Any:\n        path = \"/api/v2/crypto/trading/accounts/\"\n        return self.make_api_request(\"GET\", path)\n\n    # The symbols argument must be formatted in trading pairs, e.g \"BTC-USD\", \"ETH-USD\". If no symbols are provided,\n    # all supported symbols will be returned\n    def get_trading_pairs(self, *symbols: Optional[str]) -> list:\n        params = {\"symbol\": list(symbols)} if symbols else {}\n        query_params = self.get_query_params(params)\n        path = f\"/api/v2/crypto/trading/trading_pairs/{query_params}\"\n        \n        all_results = []\n        response = self.make_api_request(\"GET\", path)\n        \n        while response:\n            results = response.get(\"results\", [])\n            all_results.extend(results)\n            \n            next_url = response.get(\"next\")\n            if not next_url:\n                break\n            \n            next_path = next_url.replace(self.base_url, \"\")\n            response = self.make_api_request(\"GET\", next_path)\n        \n        return all_results\n\n    # The asset_codes argument must be formatted as the short form name for a crypto, e.g \"BTC\", \"ETH\". If no asset\n    # codes are provided, all crypto holdings will be returned\n    def get_holdings(self, account_number: str, *asset_codes: Optional[str]) -> Any:\n        params = {\"account_number\": account_number}\n        if asset_codes:\n            params[\"asset_code\"] = list(asset_codes)\n        query_params = self.get_query_params(params)\n        path = f\"/api/v2/crypto/trading/holdings/{query_params}\"\n        return self.make_api_request(\"GET\", path)\n\n    # The symbols argument must be formatted in trading pairs, e.g \"BTC-USD\", \"ETH-USD\".\n    def get_best_bid_ask(self, *symbols: str) -> Any:\n        params = {\"symbol\": list(symbols)} if symbols else {}\n        query_params = self.get_query_params(params)\n        path = f\"/api/v2/crypto/marketdata/best_bid_ask/{query_params}\"\n        return self.make_api_request(\"GET\", path)\n\n    # The symbol argument must be formatted in a trading pair, e.g \"BTC-USD\", \"ETH-USD\"\n    # The side argument must be \"bid\", \"ask\", or \"both\".\n    # Multiple quantities can be specified in the quantity argument, e.g. \"0.1,1,1.999\".\n    def get_estimated_price(self, symbol: str, side: str, quantity: str) -> Any:\n        params = {\"symbol\": symbol, \"side\": side, \"quantity\": quantity}\n        query_params = self.get_query_params(params)\n        path = f\"/api/v2/crypto/trading/estimated_price/{query_params}\"\n        return self.make_api_request(\"GET\", path)\n\n    def place_order(\n            self,\n            account_number: str,\n            client_order_id: str,\n            side: str,\n            order_type: str,\n            symbol: str,\n            order_config: Dict[str, str],\n    ) -> Any:\n        body = {\n            \"client_order_id\": client_order_id,\n            \"side\": side,\n            \"type\": order_type,\n            \"symbol\": symbol,\n            f\"{order_type}_order_config\": order_config,\n        }\n        params = {\"account_number\": account_number}\n        query_params = self.get_query_params(params)\n        path = f\"/api/v2/crypto/trading/orders/{query_params}\"\n        return self.make_api_request(\"POST\", path, json.dumps(body))\n\n    def cancel_order(self, order_id: str) -> Any:\n        path = f\"/api/v2/crypto/trading/orders/{order_id}/cancel/\"\n        return self.make_api_request(\"POST\", path)\n\n    def get_order(self, account_number: str, order_id: str) -> Any:\n        params = {\"account_number\": account_number}\n        query_params = self.get_query_params(params)\n        path = f\"/api/v2/crypto/trading/orders/{order_id}/{query_params}\"\n        return self.make_api_request(\"GET\", path)\n\n    def get_orders(self, account_number: str) -> Any:\n        params = {\n            \"account_number\": account_number,\n            \"created_at_start\": \"2023-01-01T20:57:50Z\"\n        }\n        query_params = self.get_query_params(params)\n        path = f\"/api/v2/crypto/trading/orders/{query_params}\"\n        return self.make_api_request(\"GET\", path)\n\n\ndef main():\n    api_trading_client = CryptoAPITradingV2()\n    print(api_trading_client.get_trading_pairs())\n    # print(api_trading_client.get_trading_pairs(\"BTC-USD\", \"ETH-USD\"))\n    # print(api_trading_client.get_best_bid_ask(\"BTC-USD\")) #\"BTC-USD\", \"ETH-USD\"\n    # print(api_trading_client.get_estimated_price(symbol=\"BTC-USD\", side=\"both\", quantity=\"0.01\"))\n\n    # accounts = api_trading_client.get_accounts()\n    # print(accounts)\n    # account_number = accounts[\"results\"][0][\"account_number\"]\n    # print(f\"account_number: {account_number}\")\n    # print(api_trading_client.get_orders(account_number))\n    # print(api_trading_client.get_holdings(account_number))\n    # print(api_trading_client.get_holdings(account_number, \"BTC\", \"ETH\"))\n\n    \"\"\"\n    BUILD YOUR TRADING STRATEGY HERE\n\n    order = api_trading_client.place_order(\n          account_number,\n          str(uuid.uuid4()),\n          \"buy\",\n          \"market\",\n          \"BTC-USD\",\n          {\"asset_quantity\": \"0.000001\"}\n    )\n    \"\"\"\n\n\nif __name__ == \"__main__\":\n    main()\n```\n\n5. Run your script from the command line\n\n```console\n# to run the Python script using the v1 API endpoints:\npython robinhood_api_trading.py\n# to run the Python script using the v2 API endpoints:\npython robinhood_api_trading_v2.py\n```\n\n\n# Pagination\n\n\n Endpoints that return a list of results allow you to paginate to have more control over how many and which results to display.\n\n\n### Pagination Parameters\n\n| Parameter | Description |\n|-|-|\n| cursor | The cursor is a unique identifier for each page in a list of results. The cursor is used to paginate through the pages of results. |\n| limit | The limit is the number of items to return in a single page. Some of our endpoints support this query parameter. You can view support by checking the query parameters in the documentation of each endpoint.  |\n\n\n### Pagination Response\n\n\n| Field | Description |\n|-|-|\n| next | The API request endpoint that includes the next cursor query parameter to use for pagination. |\n| previous | The API request endpoint that includes the previous cursor query parameter to use for pagination. |\n| results | The list of response items for the current cursor.\n\n\n# Rate Limiting\n\n\n### Rate Limits\n* Requests per minute per user account: 100\n* Requests per minute per user account in bursts: 300\n\n\nRate limiting is applied using a token bucket implementation. The burst size or `capacity` is the number of tokens you can use to call an endpoint. This capacity is initialized at the maximum capacity and will be refilled using a `refill amount` at a timed interval called `refill interval` until the max capacity is once again reached.\n\n\n### Rate Limiting Terms\n\n\n| Term | Description |\n|-|-|\n| Max capacity | The maximum amount of tokens allowed. Will no longer continue refilling if this amount is reached. |\n| Remaining amount | The number of tokens remaining that can be consumed to call an endpoint. |\n| Refill amount | The number of tokens that are refilled at each refill interval. |\n| Refill interval | The timed interval at which the tokens are refilled.\n\n The actual values of the configuration will fluctuate depending on the availability of our service and our current expected volume at the time of service. Rate limits are applied per endpoint and may differ among each endpoint depending on their expected use case.\n\n\n #### Example rate limiting configuration:\n\n\n| Term | Value |\n|-|-|\n| Max capacity | 5 |\n| Remaining amount | 2 |\n| Refill amount | 1 |\n| Refill interval | 1 second |\n\n\n| Action | Time (in seconds) | Remaining amount | Description |\n|-|-|-|-|\n| Initialize | 0 | 5 | Initial state of the token bucket. |\n| Endpoint call 1 | 0.5 | 4 | One token consumed for calling endpoint 1. |\n| Endpoint call 2 | 0.7 | 3 | One token consumed for calling endpoint 2. |\n| Refill | 1 | 4 | One token refilled at refill interval. |\n| Refill | 2 | 5 | One token refilled at refill interval. |\n| No refill | 3 | 5 | No refill since max capacity has been reached and no endpoints were called. |\n| Endpoint call 3 | 3.5 | 4 | One token consumed for calling endpoint 3.\n\n\n# Error Responses\n\n\n### Error response format\n\n#### Type\n The `type` field in the error response will be mapped to the following:\n | Error type | Status codes |\n|-|-|\n| validation_error | 400 |\n| client_error | 4XX, excluding 400 |\n| server_error | 5XX |\n\n\n#### Errors\nThe `errors` field will contain a list of error details, each item will contain a nested `attr` and `detail` field.\n| Field | Description |\n|-|-|\n| attr | Error types of `validation_error` will specify the field name or `non_field_errors` if the error cannot be attributed to a field. Will be `null` for error types of either `client_error` and `server_error`. |\n| detail | Will contain a human readable string describing the error. |\n\n\n\n### Example Error Response\nHere's a sample error response where the `client_order_id` field in the payload was a value that was not expected when calling the ***Add Crypto Order*** endpoint. The `detail` field for each error in the `errors` list will help understand why the `validation_error` was thrown. The `attr` field will indicate which field name in the request body or query parameter the error was thrown for if applicable.\n```javascript\n{\n  \"type\": \"validation_error\"\n  \"errors\": [\n    {\n      \"detail\": \"Must be a valid UUID.\",\n      \"attr\": \"client_order_id\"\n    }\n ]\n}\n```\n\n\n### Common Error Status Codes\n | Status Code | Error |\n|-|-|\n| 400 | Bad request |\n| 401 | Unauthorized |\n| 403 | Forbidden |\n| 404 | Not found |\n| 405 | Method not allowed |\n| 406 | Not acceptable |\n| 415 | Unsupported media type |\n| 429 | Too many requests |\n| 500 | Internal server error |\n| 503 | Service unavailable |"
  },
  "servers": [
    {
      "url": "https://trading.robinhood.com/"
    }
  ],
  "security": [
    {
      "API Key": [],
      "API Signature": [],
      "Timestamp": []
    }
  ],
  "paths": {
    "/api/v1/crypto/trading/accounts/": {
      "security": [
        {
          "API Key": [],
          "API Signature": [],
          "Timestamp": []
        }
      ],
      "get": {
        "tags": [
          "Account"
        ],
        "summary": "Get Crypto Trading Account Details",
        "description": "Fetches the Robinhood Crypto account details for the current user.",
        "operationId": "api_v1_crypto_trading_account_Details",
        "x-codeSamples": [
          {
            "lang": "cURL",
            "source": "curl -X \"GET\" \"https://trading.robinhood.com/api/v1/crypto/trading/accounts/\" \\\n    -H 'x-api-key: <YOUR-API-KEY>' \\\n    -H 'x-timestamp: <timestamp unix>' \\\n    -H 'x-signature: <YOUR-MSG-SIGNATURE>' \\\n    -H 'Content-Type: application/json; charset=utf-8'\n"
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Account"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/crypto/trading/trading_pairs/": {
      "security": [
        {
          "API Key": [],
          "API Signature": [],
          "Timestamp": []
        }
      ],
      "get": {
        "tags": [
          "Trading"
        ],
        "summary": "Get Crypto Trading Pairs",
        "description": "Fetch a list of trading pairs.",
        "operationId": "api_v1_crypto_trading_trading_pairs",
        "parameters": [
          {
            "name": "symbol",
            "description": "List of trading pair symbol(s) to retrieve data for.\n\nMultiple symbols can be provided by using the \"symbol\" parameter with different values. Ensure that the symbol(s) are provided in all uppercase.\n\nFor example, **?symbol=BTC-USD&symbol=ETH-USD**",
            "example": "BTC-USD",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "description": "Limit the number of results per page size",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-codeSamples": [
          {
            "lang": "cURL",
            "source": "curl -X \"GET\" \"https://trading.robinhood.com/api/v1/crypto/trading/trading_pairs/?symbol=BTC-USD\" \\\n    -H 'x-api-key: <YOUR-API-KEY>' \\\n    -H 'x-timestamp: <timestamp unix>' \\\n    -H 'x-signature: <YOUR-MSG-SIGNATURE>' \\\n    -H 'Content-Type: application/json; charset=utf-8'\n"
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "results"
                  ],
                  "type": "object",
                  "properties": {
                    "next": {
                      "type": "string",
                      "format": "uri",
                      "nullable": true,
                      "example": "https://trading.robinhood.com/api/v1/crypto/trading/trading_pairs/?cursor={CURSOR_ID}"
                    },
                    "previous": {
                      "type": "string",
                      "format": "uri",
                      "nullable": true,
                      "example": "https://trading.robinhood.com/api/v1/crypto/trading/trading_pairs/?cursor={CURSOR_ID}"
                    },
                    "results": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/TradingPair"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/crypto/trading/holdings/": {
      "security": [
        {
          "API Key": [],
          "API Signature": [],
          "Timestamp": []
        }
      ],
      "get": {
        "tags": [
          "Trading"
        ],
        "summary": "Get Crypto Holdings",
        "description": "Fetch a list of holdings for the current user.",
        "operationId": "api_v1_crypto_trading_holdings",
        "parameters": [
          {
            "name": "asset_code",
            "description": "The asset code(s) to retrieve data for.\n\nMultiple asset codes can be provided by using the \"asset_code\" parameter with different values. Ensure that the asset codes are provided in all uppercase.\n\nFor example, **?asset_code=BTC&asset_code=ETH**",
            "example": "BTC",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "description": "Limit the number of results per page size",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-codeSamples": [
          {
            "lang": "cURL",
            "source": "curl -X \"GET\" \"https://trading.robinhood.com/api/v1/crypto/trading/holdings/?asset_code=BTC\" \\\n    -H 'x-api-key: <YOUR-API-KEY>' \\\n    -H 'x-timestamp: <timestamp unix>' \\\n    -H 'x-signature: <YOUR-MSG-SIGNATURE>' \\\n    -H 'Content-Type: application/json; charset=utf-8'\n"
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "results"
                  ],
                  "type": "object",
                  "properties": {
                    "next": {
                      "type": "string",
                      "format": "uri",
                      "nullable": true,
                      "example": "https://trading.robinhood.com/api/v1/crypto/trading/holdings?cursor={CURSOR_ID}"
                    },
                    "previous": {
                      "type": "string",
                      "format": "uri",
                      "nullable": true,
                      "example": "https://trading.robinhood.com/api/v1/crypto/trading/holdings?cursor={CURSOR_ID}"
                    },
                    "results": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Holdings"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/crypto/trading/orders/": {
      "security": [
        {
          "API Key": [],
          "API Signature": [],
          "Timestamp": []
        }
      ],
      "get": {
        "tags": [
          "Trading"
        ],
        "summary": "Get Crypto Orders",
        "description": "Fetch a list of orders for the current user.",
        "operationId": "api_v1_crypto_trading_orders",
        "parameters": [
          {
            "name": "created_at_start",
            "description": "Filter by created at start time range (greater than or equal to) in ISO 8601 format",
            "example": "2023-10-31T20:57:50Z",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "created_at_end",
            "description": "Filter by created at end time range (less than or equal to) in ISO 8601 format",
            "example": "2023-10-31T20:57:50Z",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "symbol",
            "description": "Currency pair symbol. Ensure that the symbol is provided in all uppercase.",
            "example": "BTC-USD",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "description": "Order ID, unique per order",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "side",
            "description": "Buy or sell",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "buy",
                "sell"
              ]
            }
          },
          {
            "name": "state",
            "description": "State of the order",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "open",
                "canceled",
                "partially_filled",
                "filled",
                "failed"
              ]
            }
          },
          {
            "name": "type",
            "description": "Type of order",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "limit",
                "market",
                "stop_limit",
                "stop_loss"
              ]
            }
          },
          {
            "name": "updated_at_start",
            "description": "Filter by updated at start time range (greater than or equal to) in ISO 8601 format",
            "example": "2023-10-31T20:57:50Z",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "updated_at_end",
            "description": "Filter by updated at end time range (less than or equal to) in ISO 8601 format",
            "example": "2023-10-31T20:57:50Z",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "description": "Limit the number of results per page size",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "x-codeSamples": [
          {
            "lang": "cURL",
            "source": "curl -X \"GET\" \"https://trading.robinhood.com/api/v1/crypto/trading/orders/\" \\\n    -H 'x-api-key: <YOUR-API-KEY>' \\\n    -H 'x-timestamp: <timestamp unix>' \\\n    -H 'x-signature: <YOUR-MSG-SIGNATURE>' \\\n    -H 'Content-Type: application/json; charset=utf-8'\n"
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "results"
                  ],
                  "type": "object",
                  "properties": {
                    "next": {
                      "type": "string",
                      "format": "uri",
                      "nullable": true,
                      "example": "https://trading.robinhood.com/api/v1/crypto/trading/orders/?cursor={CURSOR_ID}"
                    },
                    "previous": {
                      "type": "string",
                      "format": "uri",
                      "nullable": true,
                      "example": "https://trading.robinhood.com/api/v1/crypto/trading/orders/?cursor={CURSOR_ID}"
                    },
                    "results": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/OrderResponse"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Trading"
        ],
        "summary": "Place New Crypto Order",
        "description": "Places a new crypto trading order with an order type. \n\n **Note**: Depending on the type used in the request body, you must include the respective order configuration in the request body.\n\nFor order configurations that support both `asset_quantity` or `quote_amount`, only one can be present in the request body.",
        "operationId": "api_v1_post_crypto_trading_order",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddOrder"
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "cURL",
            "source": "curl -X \"POST\" \"https://trading.robinhood.com/api/v1/crypto/trading/orders/\" \\\n    -H 'x-api-key: <YOUR-API-KEY>' \\\n    -H 'x-timestamp: <timestamp unix>' \\\n    -H 'x-signature: <YOUR-MSG-SIGNATURE>' \\\n    -H 'Content-Type: application/json; charset=utf-8' \\\n    --data-raw '{\"client_order_id\":\"131de903-5a9c-4260-abc1-28d562a5dcf0\",\"side\":\"buy\",\"type\":\"market\",\"symbol\":\"BTC-USD\",\"market_order_config\":{\"asset_quantity\":\"0.1\"}}' \n"
          }
        ],
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrderResponse"
                }
              }
            }
          },
          "400": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/crypto/trading/orders/{id}/cancel/": {
      "security": [
        {
          "API Key": [],
          "API Signature": [],
          "Timestamp": []
        }
      ],
      "post": {
        "tags": [
          "Trading"
        ],
        "summary": "Cancel Open Crypto Order",
        "description": "Cancels an open crypto trading order.",
        "operationId": "api_v1_post_crypto_trading_cancel_order",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Order ID, unique per order",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "x-codeSamples": [
          {
            "lang": "cURL",
            "source": "curl -X \"POST\" \"https://trading.robinhood.com/api/v1/crypto/trading/orders/{id}/cancel/\" \\\n    -H 'x-api-key: <YOUR-API-KEY>' \\\n    -H 'x-timestamp: <timestamp unix>' \\\n    -H 'x-signature: <YOUR-MSG-SIGNATURE>' \\\n    -H 'Content-Type: application/json; charset=utf-8' \n"
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string",
                  "description": "Success string with order id"
                },
                "example": "Cancel request was submitted for order {id}"
              }
            }
          },
          "400": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/crypto/marketdata/best_bid_ask/": {
      "security": [
        {
          "API Key": [],
          "API Signature": [],
          "Timestamp": []
        }
      ],
      "get": {
        "tags": [
          "Market Data"
        ],
        "summary": "Get Best Price",
        "description": "Fetch a single bid and ask price per symbol, representing the best available price across our partner market makers. This price does not take into account the order size, and may not be the final execution price.\n\nThe bid and ask prices include a spread. The buy spread is the percent difference between the ask and the mid price. The sell spread is the percent difference between the bid and the mid price.\n\nNote that in the v2 endpoint, **Place crypto orders with fee tiers**, partner exchanges provide prices instead of market makers, with orders routed accordingly. For more information on routing, visit our [<u>Help Center</u>](https://robinhood.com/us/en/support/articles/crypto-order-routing/).",
        "operationId": "api_v1_crypto_marketdata_best_bid_ask",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "description": "List of trading pair symbol(s) to retrieve data for.\n\nMultiple symbols can be provided by using the \"symbol\" parameter with different values. Ensure that the symbol(s) are provided in all uppercase.\n\nFor example, **?symbol=BTC-USD&symbol=ETH-USD**",
            "example": "BTC-USD",
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-codeSamples": [
          {
            "lang": "cURL",
            "source": "curl -X \"GET\" \"https://trading.robinhood.com/api/v1/crypto/marketdata/best_bid_ask/?symbol=BTC-USD\" \\\n    -H 'x-api-key: <YOUR-API-KEY>' \\\n    -H 'x-timestamp: <timestamp unix>' \\\n    -H 'x-signature: <YOUR-MSG-SIGNATURE>' \\\n    -H 'Content-Type: application/json; charset=utf-8' \n"
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "results"
                  ],
                  "type": "object",
                  "properties": {
                    "results": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/BidAskPrice"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/crypto/marketdata/estimated_price/": {
      "security": [
        {
          "API Key": [],
          "API Signature": [],
          "Timestamp": []
        }
      ],
      "get": {
        "tags": [
          "Market Data"
        ],
        "summary": "Get Estimated Price",
        "description": "This endpoint returns the estimated total cost or credit for a particular symbol, book side, and asset quantity. You can include a list of quantities in a single request to retrieve the price for various hypothetical order sizes. \n\nThe estimated price represents the expected execution price if you were to subsequently place an order. To estimate the cost for a Buy order, request an Ask quote. If you are preparing to place a Sell order, request a Bid quote. The execution price may vary due to market volatility and once executed the transaction may not be undone.\n\nThe bid and ask prices are the best prices our market makers provide for an order, inclusive of a spread. The buy spread is the percent difference between the ask and the mid price. The sell spread is the percent difference between the bid and the mid price.",
        "operationId": "api_v1_crypto_marketdata_estimated_price",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "description": "A string matching a valid currency pair, for example BTC-USD. Ensure that the symbol is provided in all uppercase.\n\nOnly USD symbols are accepted.",
            "example": "BTC-USD",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "side",
            "in": "query",
            "description": "Order side. e.g. bid, ask, or both.",
            "example": "bid",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "bid",
                "ask",
                "both"
              ]
            }
          },
          {
            "name": "quantity",
            "in": "query",
            "description": "Quantity must be between `min_order_size` and `max_order_size` as defined in our `Get Crypto Trading Pairs` endpoint.\n\n A max of 10 quantities can be specified for each request.",
            "example": "0.1,1,1.999",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "x-codeSamples": [
          {
            "lang": "cURL",
            "source": "curl -X \"GET\" \"https://trading.robinhood.com/marketdata/api/v1/estimated_price/?symbol=BTC-USD&side=ask&quantity=0.1,1,1.999\" \\\n    -H 'x-api-key: <YOUR-API-KEY>' \\\n    -H 'x-timestamp: <timestamp unix>' \\\n    -H 'x-signature: <YOUR-MSG-SIGNATURE>' \\\n    -H 'Content-Type: application/json; charset=utf-8' \n"
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "results"
                  ],
                  "type": "object",
                  "properties": {
                    "results": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/EstimatedPrice"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/crypto/trading/accounts/": {
      "security": [
        {
          "API Key": [],
          "API Signature": [],
          "Timestamp": []
        }
      ],
      "get": {
        "tags": [
          "V2 Account"
        ],
        "summary": "Get Accounts",
        "description": "Retrieve a paginated list of crypto trading accounts for the authenticated user. Returns account details including buying power, status, and fee tier information.",
        "operationId": "api_v2_crypto_trading_accounts",
        "parameters": [
          {
            "name": "cursor",
            "description": "Optional cursor for pagination. Use the value from `next` or `previous` in the response to navigate through pages.",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "description": "Optional page size limit. Specifies the number of accounts to return per page. Maximum value is determined by system configuration.",
            "in": "query",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V2AccountsResponse"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/crypto/trading/trading_pairs/": {
      "security": [
        {
          "API Key": [],
          "API Signature": [],
          "Timestamp": []
        }
      ],
      "get": {
        "tags": [
          "V2 Trading"
        ],
        "summary": "Get Trading Pairs",
        "description": "Fetch a paginated list of available trading pairs for crypto trading. Returns trading pair details including price increments, order size limits, and tradability status. Trading pairs can be filtered by symbol.",
        "operationId": "api_v2_crypto_trading_trading_pairs",
        "parameters": [
          {
            "name": "symbol",
            "description": "Optional. Filter by trading pair symbol(s). Example: `symbol=BTC-USD`. Multiple symbols can be provided by using the \"symbol\" parameter with different values. Ensure that the symbol(s) are provided in all uppercase.\n\nFor example, `?symbol=BTC-USD&symbol=ETH-USD`.\n\nIf the \"symbol\" parameter is not provided, this endpoint will return all tradable currency pairs.",
            "example": "BTC-USD",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "description": "Optional cursor for pagination. Use the value from `next` or `previous` in the response to navigate through pages.",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "description": "Optional page size limit. Specifies the number of results to return per page. Maximum value is determined by system configuration.",
            "in": "query",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V2TradingPairsResponse"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/crypto/trading/holdings/": {
      "security": [
        {
          "API Key": [],
          "API Signature": [],
          "Timestamp": []
        }
      ],
      "get": {
        "tags": [
          "V2 Trading"
        ],
        "summary": "Get Holdings",
        "description": "Retrieve a paginated list of crypto holdings for a specific account. Returns the total quantity and available quantity for each asset held in the account. The `account_number` query parameter is required.",
        "operationId": "api_v2_crypto_trading_holdings",
        "parameters": [
          {
            "name": "account_number",
            "description": "**Required.** The account number to retrieve holdings for. This parameter must be provided.",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "asset_code",
            "description": "Optional. Filter holdings by specific asset code (e.g., \"BTC\").",
            "example": "BTC",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "description": "Optional cursor for pagination. Use the value from `next` or `previous` in the response to navigate through pages.",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "description": "Optional page size limit. Specifies the number of results to return per page. Maximum value is determined by system configuration.",
            "in": "query",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V2HoldingsResponse"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/crypto/marketdata/best_bid_ask/": {
      "security": [
        {
          "API Key": [],
          "API Signature": [],
          "Timestamp": []
        }
      ],
      "get": {
        "tags": [
          "V2 Market Data"
        ],
        "summary": "Get Best Price",
        "description": "Fetch a single bid and ask price per symbol, representing the best available price across our partner exchanges. This price does not take into account the order size or fee, and may not be the final execution price.",
        "operationId": "api_v2_crypto_marketdata_best_bid_ask",
        "parameters": [
          {
            "name": "symbol",
            "description": "List of trading pair symbol(s) to retrieve data for.\n\nMultiple symbols can be provided by using the \"symbol\" parameter with different values. Ensure that the symbol(s) are provided in all uppercase. Only USD symbols that have `is_api_tradable=true` as defined in our Get Crypto Trading Pairs endpoint are accepted.\n\nFor example, `?symbol=BTC-USD&symbol=ETH-USD`",
            "example": "BTC-USD",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V2BestBidAskResponse"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "validation_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": "string"
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/crypto/trading/estimated_price/": {
      "security": [
        {
          "API Key": [],
          "API Signature": [],
          "Timestamp": []
        }
      ],
      "get": {
        "tags": [
          "V2 Market Data"
        ],
        "summary": "Get Estimated Price",
        "description": "This endpoint returns the estimated total cost or credit for a particular symbol, book side, asset quantity, and fee. You can include a list of quantities in a single request to retrieve the price for various hypothetical order sizes.\n\nThe estimated price represents the expected execution price if you were to subsequently place an order. The execution price may vary due to market volatility and once executed the transaction may not be undone.\n\nThe bid and ask prices are the best prices our partner exchanges provide for an order, excluding the fee.",
        "operationId": "api_v2_crypto_marketdata_estimated_price",
        "parameters": [
          {
            "name": "symbol",
            "description": "A string matching a valid currency pair, for example `BTC-USD`. Ensure that the symbol is provided in all uppercase. Only USD symbols that have `is_api_tradable=true` as defined in our Get Crypto Trading Pairs endpoint are accepted.",
            "example": "BTC-USD",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "side",
            "description": "Order side: `bid`, `ask`, or `both`.",
            "example": "bid",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "bid",
                "ask",
                "both"
              ]
            }
          },
          {
            "name": "quantity",
            "description": "Quantity must be smaller than `max_order_size` as defined in our Get Crypto Trading Pairs endpoint. Multiple quantities can be comma-separated. A max of 10 quantities can be specified for each request.",
            "example": "0.1,1,1.999",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V2EstimatedPriceResponse"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "validation_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": "string"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/crypto/trading/orders/": {
      "security": [
        {
          "API Key": [],
          "API Signature": [],
          "Timestamp": []
        }
      ],
      "get": {
        "tags": [
          "V2 Trading"
        ],
        "summary": "Get Orders",
        "description": "Fetch a list of orders for the current user in a specific account.",
        "operationId": "api_v2_crypto_trading_orders_get",
        "parameters": [
          {
            "name": "account_number",
            "description": "Required. The number of the crypto account to retrieve orders from.",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "description": "Optional cursor for pagination.",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "created_at_start",
            "description": "Filter orders created on or after this timestamp (ISO 8601 format).",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "created_at_end",
            "description": "Filter orders created on or before this timestamp (ISO 8601 format).",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "updated_at_start",
            "description": "Filter orders updated on or after this timestamp (ISO 8601 format).",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "updated_at_end",
            "description": "Filter orders updated on or before this timestamp (ISO 8601 format).",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "symbol",
            "description": "Filter orders by trading pair symbol.",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "side",
            "description": "Filter orders by side.",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "buy",
                "sell"
              ]
            }
          },
          {
            "name": "type",
            "description": "Filter orders by type.",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "market",
                "limit",
                "stop_loss",
                "stop_limit"
              ]
            }
          },
          {
            "name": "state",
            "description": "Filter orders by state.",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "open",
                "canceled",
                "filled",
                "failed",
                "pending"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V2OrdersResponse"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "V2 Trading"
        ],
        "summary": "Place New Crypto Order",
        "description": "Place a new crypto trading order with an order type. This endpoint only supports placing orders on USD symbols that have `is_api_tradable=true` as defined in our Get Crypto Trading Pairs endpoint.\n\n**Note:** Depending on the type used in the request body, you must include the respective order configuration in the request body.\n\nFor order configurations that support both `asset_quantity` or `quote_amount`, only one can be present in the request body.",
        "operationId": "api_v2_crypto_trading_orders_post",
        "parameters": [
          {
            "name": "account_number",
            "description": "Required. The number of the crypto account to place orders from.",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddOrderV2"
              }
            }
          }
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V2CryptoOrder"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/crypto/trading/orders/{id}/cancel/": {
      "security": [
        {
          "API Key": [],
          "API Signature": [],
          "Timestamp": []
        }
      ],
      "post": {
        "tags": [
          "V2 Trading"
        ],
        "summary": "Cancel Open Crypto Order",
        "description": "Cancels an open crypto trading order.",
        "operationId": "api_v2_crypto_trading_cancel_order",
        "parameters": [
          {
            "name": "id",
            "description": "The ID of the order to cancel.",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V2CryptoOrder"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "validation_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": "string"
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "type": "client_error",
                  "errors": [
                    {
                      "detail": "string",
                      "attr": null
                    }
                  ]
                }
              }
            }
          }
        }
      }
    }
  },
  "tags": [
    {
      "name": "V2 Account",
      "x-displayName": "Account"
    },
    {
      "name": "V2 Market Data",
      "x-displayName": "Market Data"
    },
    {
      "name": "V2 Trading",
      "x-displayName": "Trading"
    }
  ],
  "components": {
    "requestParameters": {
      "TimeInForce": {
        "description": "The time in force of the order.\n\n- **Good til canceled (gtc):** The order remains open until it's filled or the user cancels it.\n\n- **Good for day (gfd):** The order remains open until the end of the day or when the user cancels it.\n\n- **Good for week (gfw):** The order remains open until the end of the week or when the user cancels it.\n\n- **Good for month (gfm):** The order remains open until the end of the month or when the user cancels it.",
        "type": "string",
        "enum": [
          "gtc",
          "gfd",
          "gfw",
          "gfm"
        ]
      }
    },
    "schemas": {
      "Account": {
        "type": "object",
        "properties": {
          "account_number": {
            "title": "Account number",
            "description": "The account number of the crypto account",
            "type": "string",
            "readOnly": true
          },
          "status": {
            "title": "Status",
            "description": "User account status for trading",
            "type": "string",
            "enum": [
              "active",
              "deactivated",
              "sell_only"
            ]
          },
          "buying_power": {
            "title": "Buying power",
            "description": "User buying power amount in fiat currency",
            "type": "string",
            "readOnly": true
          },
          "buying_power_currency": {
            "title": "Buying power currency",
            "description": "Example: USD",
            "type": "string",
            "readOnly": true
          }
        }
      },
      "V2Account": {
        "type": "object",
        "properties": {
          "account_number": {
            "title": "Account number",
            "description": "The unique account number identifier.",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "description": "The current status of the account.",
            "type": "string",
            "enum": [
              "active",
              "deactivated",
              "sell_only"
            ]
          },
          "buying_power": {
            "title": "Buying power",
            "description": "The available buying power in the account.",
            "type": "string"
          },
          "buying_power_currency": {
            "title": "Buying power currency",
            "description": "The currency of the buying power (e.g., \"USD\").",
            "type": "string"
          },
          "account_type": {
            "title": "Account type",
            "description": "The type of account (e.g., individual).",
            "type": "string"
          },
          "is_api_tradable": {
            "title": "Is API tradable",
            "description": "Indicates whether the account can be used for API trading. True for the default account.",
            "type": "boolean"
          },
          "fee_tier_status": {
            "title": "Fee tier status",
            "description": "Optional. Fee tier information for the account, if available. See object fields below.",
            "allOf": [
              {
                "$ref": "#/components/schemas/FeeTierStatus"
              }
            ]
          }
        }
      },
      "FeeTierStatus": {
        "type": "object",
        "properties": {
          "fee_ratio": {
            "title": "Fee ratio",
            "description": "The current fee ratio applied to the value executed for each order.",
            "type": "number",
            "format": "double"
          },
          "thirty_day_volume": {
            "title": "Thirty day volume",
            "description": "Trailing 30-day trading volume of crypto fee tier orders.",
            "type": "number",
            "format": "double"
          },
          "next_fee_tier_ratio": {
            "title": "Next fee tier ratio",
            "description": "Optional. The fee ratio for the next tier. Null if already at the highest tier (lowest fee).",
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "next_fee_tier_threshold": {
            "title": "Next fee tier threshold",
            "description": "Optional. The trading volume required to reach the next fee tier. Null if already at the highest tier (lowest fee).",
            "type": "number",
            "format": "double",
            "nullable": true
          }
        }
      },
      "V2AccountsResponse": {
        "type": "object",
        "properties": {
          "next": {
            "title": "Next",
            "description": "URI for the next page of results. Null if there are no more pages.",
            "type": "string",
            "nullable": true
          },
          "previous": {
            "title": "Previous",
            "description": "URI for the previous page of results. Null if on the first page.",
            "type": "string",
            "nullable": true
          },
          "results": {
            "title": "Results",
            "description": "Array of account objects with the following fields:",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/V2Account"
            }
          }
        }
      },
      "V2TradingPair": {
        "type": "object",
        "properties": {
          "symbol": {
            "title": "Symbol",
            "description": "The trading pair symbol (e.g., \"BTC-USD\").",
            "type": "string"
          },
          "asset_code": {
            "title": "Asset code",
            "description": "The code for the asset currency (e.g., \"BTC\").",
            "type": "string"
          },
          "quote_code": {
            "title": "Quote code",
            "description": "The code for the quote currency (e.g., \"USD\").",
            "type": "string"
          },
          "asset_increment": {
            "title": "Asset increment",
            "description": "The minimum quantity increment for placing orders in the asset currency. Up to 18 decimal places.",
            "type": "string"
          },
          "quote_increment": {
            "title": "Quote increment",
            "description": "The minimum price increment for placing orders in the quote currency. Up to 18 decimal places.",
            "type": "string"
          },
          "max_order_size": {
            "title": "Max order size",
            "description": "The maximum order size allowed for this trading pair in asset currency. Up to 16 decimal places.",
            "type": "string"
          },
          "min_order_amount": {
            "title": "Min order amount",
            "description": "The minimum order amount in quote currency (e.g., USD) required for fee tier orders.",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "description": "The tradability status of the trading pair.",
            "type": "string"
          },
          "is_api_tradable": {
            "title": "Is API tradable",
            "description": "Indicates whether the trading pair is supported on API trading v2 endpoints (**Place crypto orders with fee tiers**).",
            "type": "boolean"
          }
        }
      },
      "V2TradingPairsResponse": {
        "type": "object",
        "properties": {
          "next": {
            "title": "Next",
            "description": "URI for the next page of results. Null if there are no more pages.",
            "type": "string",
            "nullable": true
          },
          "previous": {
            "title": "Previous",
            "description": "URI for the previous page of results. Null if on the first page.",
            "type": "string",
            "nullable": true
          },
          "results": {
            "title": "Results",
            "description": "Array of trading pair objects.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/V2TradingPair"
            }
          }
        }
      },
      "V2Holding": {
        "type": "object",
        "properties": {
          "account_number": {
            "title": "Account number",
            "description": "The account number that holds this asset.",
            "type": "string"
          },
          "asset_code": {
            "title": "Asset code",
            "description": "The code for the crypto asset (e.g., \"BTC\", \"ETH\").",
            "type": "string"
          },
          "total_quantity": {
            "title": "Total quantity",
            "description": "The total quantity of the asset held in the account, including any amounts that are not available for trading.",
            "type": "string"
          },
          "quantity_available_for_trading": {
            "title": "Quantity available for trading",
            "description": "The quantity of the asset that is currently available for trading (not locked in pending orders or other operations).",
            "type": "string"
          }
        }
      },
      "V2HoldingsResponse": {
        "type": "object",
        "properties": {
          "next": {
            "title": "Next",
            "description": "URI for the next page of results. Null if there are no more pages.",
            "type": "string",
            "nullable": true
          },
          "previous": {
            "title": "Previous",
            "description": "URI for the previous page of results. Null if on the first page.",
            "type": "string",
            "nullable": true
          },
          "results": {
            "title": "Results",
            "description": "Array of holding objects.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/V2Holding"
            }
          }
        }
      },
      "V2BestBidAsk": {
        "type": "object",
        "properties": {
          "symbol": {
            "title": "Symbol",
            "description": "Currency pair symbol.",
            "type": "string"
          },
          "bid": {
            "title": "Bid",
            "description": "The best price our partner exchanges provide for a sell order.",
            "type": "number",
            "format": "double"
          },
          "ask": {
            "title": "Ask",
            "description": "The best price our partner exchanges provide for a buy order.",
            "type": "number",
            "format": "double"
          }
        }
      },
      "V2BestBidAskResponse": {
        "type": "object",
        "properties": {
          "results": {
            "title": "Results",
            "description": "Array of bid/ask price objects.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/V2BestBidAsk"
            }
          }
        }
      },
      "V2EstimatedPrice": {
        "type": "object",
        "properties": {
          "symbol": {
            "title": "Symbol",
            "description": "The trading pair symbol.",
            "type": "string"
          },
          "side": {
            "title": "Side",
            "description": "Order quote side (bid or ask).",
            "type": "string",
            "enum": [
              "bid",
              "ask"
            ]
          },
          "quantity": {
            "title": "Quantity",
            "description": "Quantity of base currency.",
            "type": "number",
            "format": "double"
          },
          "timestamp": {
            "title": "Timestamp",
            "description": "The time when the price was retrieved from our system.",
            "type": "string",
            "format": "date-time"
          },
          "bid": {
            "title": "Bid",
            "description": "The best price our partner exchanges provide for a sell order.",
            "type": "number",
            "format": "double"
          },
          "ask": {
            "title": "Ask",
            "description": "The best price our partner exchanges provide for a buy order.",
            "type": "number",
            "format": "double"
          },
          "fee_ratio": {
            "title": "Fee ratio",
            "description": "The fee ratio applied to the value executed for each order. For example, 0.0085 corresponds to a 0.85% trading fee.",
            "type": "number",
            "format": "double"
          },
          "est_fee": {
            "title": "Estimated fee",
            "description": "The estimated transaction fee in quote currency (e.g., USD). Calculated as fee_ratio * (price * quantity).",
            "type": "number",
            "format": "double"
          },
          "est_total_cost": {
            "title": "Estimated total cost",
            "description": "The estimated total cost in quote currency for a buy order, including the fee. Calculated as quantity * ask + est_fee.",
            "type": "number",
            "format": "double"
          },
          "est_total_credit": {
            "title": "Estimated total credit",
            "description": "The estimated total credit in quote currency for a sell order, after deducting the fee. Calculated as quantity * bid - est_fee.",
            "type": "number",
            "format": "double"
          }
        }
      },
      "V2EstimatedPriceResponse": {
        "type": "object",
        "properties": {
          "results": {
            "title": "Results",
            "description": "Array of estimated price objects.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/V2EstimatedPrice"
            }
          }
        }
      },
      "V2CryptoOrder": {
        "type": "object",
        "description": "V2 Crypto order with fee tier information. Includes all V1 order fields plus fee_charged and estimated_fee_remaining.",
        "allOf": [
          {
            "$ref": "#/components/schemas/OrderResponse"
          },
          {
            "type": "object",
            "properties": {
              "fee_charged": {
                "title": "Fee charged",
                "description": "The total fee amount that was charged for this order based on executed fills.",
                "type": "number",
                "format": "double"
              },
              "estimated_fee_remaining": {
                "title": "Estimated fee remaining",
                "description": "The estimated fee amount that will be charged on the remaining unfilled quantity of the order. The amount depends on the execution price and may vary due to market volatility.",
                "type": "number",
                "format": "double"
              }
            }
          }
        ]
      },
      "V2OrdersResponse": {
        "type": "object",
        "properties": {
          "next": {
            "title": "Next",
            "description": "URI for the next page of results. Null if there are no more pages.",
            "type": "string",
            "nullable": true
          },
          "previous": {
            "title": "Previous",
            "description": "URI for the previous page of results. Null if on the first page.",
            "type": "string",
            "nullable": true
          },
          "results": {
            "title": "Results",
            "description": "Array of order objects with fee information.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/V2CryptoOrder"
            }
          }
        }
      },
      "BidAskPrice": {
        "type": "object",
        "properties": {
          "symbol": {
            "title": "Symbol",
            "description": "Currency pair symbol",
            "type": "string"
          },
          "price": {
            "title": "Price",
            "description": "Midpoint of `bid_inclusive_of_sell_spread` and `ask_inclusive_of_buy_spread`",
            "type": "number",
            "format": "double"
          },
          "bid_inclusive_of_sell_spread": {
            "title": "Bid inclusive of sell spread",
            "description": "The best price our market makers provide for a sell order inclusive of the sell spread",
            "type": "number",
            "format": "double"
          },
          "sell_spread": {
            "title": "Sell spread",
            "description": "The percent difference between the bid and the mid price, included in `bid_inclusive_of_sell_spread`",
            "type": "number",
            "format": "double"
          },
          "ask_inclusive_of_buy_spread": {
            "title": "Ask inclusive of buy spread",
            "description": "The best price our market makers provide for a buy order inclusive of the buy spread",
            "type": "number",
            "format": "double"
          },
          "buy_spread": {
            "title": "Buy spread",
            "description": "The percent difference between the ask and the mid price, included in `ask_inclusive_of_buy_spread`",
            "type": "number",
            "format": "double"
          },
          "timestamp": {
            "title": "Timestamp",
            "description": "The time when the price was retrieved from our system",
            "type": "string"
          }
        }
      },
      "EstimatedPrice": {
        "type": "object",
        "properties": {
          "symbol": {
            "title": "Symbol",
            "description": "Currency pair symbol",
            "type": "string"
          },
          "side": {
            "title": "Side",
            "description": "Order quote side",
            "type": "string",
            "enum": [
              "bid",
              "ask"
            ]
          },
          "price": {
            "title": "Price",
            "description": "Midpoint of `bid_inclusive_of_sell_spread` and `ask_inclusive_of_buy_spread`",
            "type": "number",
            "format": "double"
          },
          "quantity": {
            "title": "Quantity",
            "description": "Quantity of base currency",
            "type": "number",
            "format": "double"
          },
          "bid_inclusive_of_sell_spread": {
            "title": "Bid inclusive of sell spread",
            "description": " The best price our market makers  provide for a sell order inclusive of the sell spread",
            "type": "number",
            "format": "double"
          },
          "sell_spread": {
            "title": "Sell spread",
            "description": "The percent difference between the bid and the mid price, included in `bid_inclusive_of_sell_spread`",
            "type": "number",
            "format": "double"
          },
          "ask_inclusive_of_buy_spread": {
            "title": "Ask inclusive of buy spread",
            "description": "The best price our market makers provide for a buy order inclusive of the buy spread",
            "type": "number",
            "format": "double"
          },
          "buy_spread": {
            "title": "Buy spread",
            "description": "The percent difference between the ask and the mid price, included in `ask_inclusive_of_buy_spread`",
            "type": "number",
            "format": "double"
          },
          "timestamp": {
            "title": "Timestamp",
            "description": "The time when the price was retrieved from our system",
            "type": "string"
          }
        }
      },
      "Holdings": {
        "type": "object",
        "properties": {
          "account_number": {
            "title": "The account number of the crypto account",
            "type": "string"
          },
          "asset_code": {
            "title": "Asset currency code",
            "type": "string"
          },
          "total_quantity": {
            "title": "Total coin quantity user holds",
            "type": "number",
            "format": "double"
          },
          "quantity_available_for_trading": {
            "title": "Available coin quantity user can trade (sell)",
            "type": "number",
            "format": "double"
          }
        }
      },
      "TradingPair": {
        "type": "object",
        "properties": {
          "asset_code": {
            "title": "Asset currency code",
            "description": "Example: BTC",
            "type": "string"
          },
          "quote_code": {
            "title": "Quote currency code",
            "description": "Example: USD",
            "type": "string"
          },
          "quote_increment": {
            "title": "Quote increment",
            "description": "The precision of the currency price increment.",
            "type": "string"
          },
          "asset_increment": {
            "title": "Asset increment",
            "description": "The precision of the order of the currency quantity increment.",
            "type": "string"
          },
          "max_order_size": {
            "title": "Maximum order size",
            "description": "The largest quantity a user can place for the coin per order.",
            "type": "string"
          },
          "min_order_size": {
            "title": "Minimum order size",
            "description": "The smallest quantity a user has to place for the coin per order.",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "description": "The status of the currency pair.",
            "type": "string",
            "enum": [
              "tradable",
              "untradable",
              "sellonly"
            ]
          },
          "symbol": {
            "title": "Symbol for this currency pair",
            "description": "Example: BTC-USD",
            "type": "string"
          }
        }
      },
      "OrderResponse": {
        "type": "object",
        "properties": {
          "id": {
            "title": "Order ID",
            "description": "Unique per order",
            "type": "string",
            "format": "uuid"
          },
          "account_number": {
            "title": "Account number",
            "description": "The account number of the crypto account",
            "type": "string"
          },
          "symbol": {
            "title": "Symbol",
            "description": "Currency pair symbol",
            "type": "string"
          },
          "client_order_id": {
            "title": "Client order ID",
            "description": "User input order id for idempotency validation",
            "type": "string",
            "format": "uuid"
          },
          "side": {
            "title": "Side",
            "description": "Buy or sell",
            "type": "string",
            "enum": [
              "buy",
              "sell"
            ]
          },
          "executions": {
            "items": {
              "$ref": "#/components/schemas/OrderExecution"
            },
            "readOnly": true,
            "type": "array"
          },
          "type": {
            "description": "Type of order",
            "type": "string",
            "enum": [
              "limit",
              "market",
              "stop_limit",
              "stop_loss"
            ]
          },
          "state": {
            "description": "State of the order",
            "type": "string",
            "enum": [
              "open",
              "canceled",
              "partially_filled",
              "filled",
              "failed"
            ]
          },
          "average_price": {
            "description": "Average price of all executions",
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "filled_asset_quantity": {
            "description": "Portion of total amount that have been filled",
            "type": "number",
            "format": "double"
          },
          "created_at": {
            "description": "The timestamp of when the order was created",
            "type": "string"
          },
          "updated_at": {
            "description": "The timestamp of when the order was updated",
            "type": "string"
          },
          "market_order_config": {
            "description": "Order configuration for market orders",
            "type": "object",
            "properties": {
              "asset_quantity": {
                "description": "The quantity of base currency bought or sold",
                "type": "number",
                "format": "double"
              }
            }
          },
          "limit_order_config": {
            "description": "Order configuration for limit orders",
            "type": "object",
            "properties": {
              "quote_amount": {
                "description": "The amount of quote currency bought or sold",
                "type": "number",
                "format": "double"
              },
              "asset_quantity": {
                "description": "The quantity of base currency bought or sold",
                "type": "number",
                "format": "double"
              },
              "limit_price": {
                "description": "The limit price of the order bought or sold",
                "type": "number",
                "format": "double"
              }
            }
          },
          "stop_loss_order_config": {
            "description": "Order configuration for stop loss orders",
            "type": "object",
            "properties": {
              "quote_amount": {
                "description": "The amount of quote currency bought or sold",
                "type": "number",
                "format": "double"
              },
              "asset_quantity": {
                "description": "The quantity of base currency bought or sold",
                "type": "number",
                "format": "double"
              },
              "stop_price": {
                "description": "The stop price of the order bought or sold",
                "type": "number",
                "format": "double"
              },
              "time_in_force": {
                "$ref": "#/components/requestParameters/TimeInForce"
              }
            }
          },
          "stop_limit_order_config": {
            "description": "Order configuration for stop limit orders",
            "type": "object",
            "properties": {
              "quote_amount": {
                "description": "The amount of quote currency bought or sold",
                "type": "number",
                "format": "double"
              },
              "asset_quantity": {
                "description": "The quantity of base currency bought or sold",
                "type": "number",
                "format": "double"
              },
              "limit_price": {
                "description": "The limit price of the order bought or sold",
                "type": "number",
                "format": "double"
              },
              "stop_price": {
                "description": "The stop price of the order bought or sold",
                "type": "number",
                "format": "double"
              },
              "time_in_force": {
                "$ref": "#/components/requestParameters/TimeInForce"
              }
            }
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "The error type of the response",
            "enum": [
              "validation_error",
              "client_error",
              "server_error"
            ]
          },
          "errors": {
            "type": "array",
            "description": "List of errors",
            "items": {
              "type": "object",
              "properties": {
                "detail": {
                  "type": "string",
                  "description": "The error message detail for the error item"
                },
                "attr": {
                  "type": "string",
                  "description": "The attribute name of the error item, typically the field name of the request body or query parameter.",
                  "nullable": true
                }
              }
            }
          }
        }
      },
      "AddOrder": {
        "type": "object",
        "required": [
          "symbol",
          "client_order_id",
          "side",
          "type"
        ],
        "properties": {
          "symbol": {
            "title": "Symbol",
            "description": "Example: **BTC-USD**\n\nCurrency pair symbol. Ensure that the symbol is provided in all uppercase.",
            "type": "string"
          },
          "client_order_id": {
            "title": "Client order ID",
            "description": "User input order id for idempotency validation",
            "type": "string",
            "format": "uuid"
          },
          "side": {
            "title": "Side",
            "description": "Buy or sell",
            "type": "string",
            "enum": [
              "buy",
              "sell"
            ]
          },
          "type": {
            "description": "Type of order",
            "type": "string",
            "enum": [
              "limit",
              "market",
              "stop_limit",
              "stop_loss"
            ]
          },
          "market_order_config": {
            "description": "Market order configuration \n\n***Required for market orders**",
            "type": "object",
            "properties": {
              "asset_quantity": {
                "description": "The quantity of base currency bought or sold",
                "type": "number",
                "format": "double"
              }
            }
          },
          "limit_order_config": {
            "description": "Limit order configuration \n\n***Required for limit orders**",
            "type": "object",
            "properties": {
              "quote_amount": {
                "description": "The amount of quote currency bought or sold",
                "type": "number",
                "format": "double"
              },
              "asset_quantity": {
                "description": "The quantity of base currency bought or sold",
                "type": "number",
                "format": "double"
              },
              "limit_price": {
                "description": "The limit price of the order bought or sold",
                "type": "number",
                "format": "double"
              }
            }
          },
          "stop_loss_order_config": {
            "description": "Stop loss order configuration \n\n***Required for stop loss orders**",
            "type": "object",
            "properties": {
              "quote_amount": {
                "description": "The amount of quote currency bought or sold",
                "type": "number",
                "format": "double"
              },
              "asset_quantity": {
                "description": "The quantity of base currency bought or sold",
                "type": "number",
                "format": "double"
              },
              "stop_price": {
                "description": "The stop price of the order bought or sold",
                "type": "number",
                "format": "double"
              },
              "time_in_force": {
                "$ref": "#/components/requestParameters/TimeInForce"
              }
            }
          },
          "stop_limit_order_config": {
            "description": "Stop limit order configuration \n\n***Required for stop limit orders**",
            "type": "object",
            "properties": {
              "quote_amount": {
                "description": "The amount of quote currency bought or sold",
                "type": "number",
                "format": "double"
              },
              "asset_quantity": {
                "description": "The quantity of base currency bought or sold",
                "type": "number",
                "format": "double"
              },
              "limit_price": {
                "description": "The limit price of the order bought or sold",
                "type": "number",
                "format": "double"
              },
              "stop_price": {
                "description": "The stop price of the order bought or sold",
                "type": "number",
                "format": "double"
              },
              "time_in_force": {
                "$ref": "#/components/requestParameters/TimeInForce"
              }
            }
          }
        }
      },
      "AddOrderV2": {
        "type": "object",
        "required": [
          "symbol",
          "client_order_id",
          "side",
          "type"
        ],
        "properties": {
          "symbol": {
            "title": "Symbol",
            "description": "Example: **BTC-USD**\n\nCurrency pair symbol. Ensure that the symbol is provided in all uppercase.",
            "type": "string"
          },
          "client_order_id": {
            "title": "Client order ID",
            "description": "User input order id for idempotency validation",
            "type": "string",
            "format": "uuid"
          },
          "side": {
            "title": "Side",
            "description": "Buy or sell",
            "type": "string",
            "enum": [
              "buy",
              "sell"
            ]
          },
          "type": {
            "description": "Type of order",
            "type": "string",
            "enum": [
              "limit",
              "market",
              "stop_limit",
              "stop_loss"
            ]
          },
          "market_order_config": {
            "description": "Market order configuration \n\n***Required for market orders**",
            "type": "object",
            "properties": {
              "asset_quantity": {
                "description": "The quantity of base currency bought or sold",
                "type": "number",
                "format": "double"
              }
            }
          },
          "limit_order_config": {
            "description": "Limit order configuration \n\n***Required for limit orders**",
            "type": "object",
            "properties": {
              "quote_amount": {
                "description": "The amount of quote currency bought or sold",
                "type": "number",
                "format": "double"
              },
              "asset_quantity": {
                "description": "The quantity of base currency bought or sold",
                "type": "number",
                "format": "double"
              },
              "limit_price": {
                "description": "The limit price of the order bought or sold",
                "type": "number",
                "format": "double"
              },
              "time_in_force": {
                "$ref": "#/components/requestParameters/TimeInForce"
              }
            }
          },
          "stop_loss_order_config": {
            "description": "Stop loss order configuration \n\n***Required for stop loss orders**",
            "type": "object",
            "properties": {
              "quote_amount": {
                "description": "The amount of quote currency bought or sold",
                "type": "number",
                "format": "double"
              },
              "asset_quantity": {
                "description": "The quantity of base currency bought or sold",
                "type": "number",
                "format": "double"
              },
              "stop_price": {
                "description": "The stop price of the order bought or sold",
                "type": "number",
                "format": "double"
              },
              "time_in_force": {
                "$ref": "#/components/requestParameters/TimeInForce"
              }
            }
          },
          "stop_limit_order_config": {
            "description": "Stop limit order configuration \n\n***Required for stop limit orders**",
            "type": "object",
            "properties": {
              "quote_amount": {
                "description": "The amount of quote currency bought or sold",
                "type": "number",
                "format": "double"
              },
              "asset_quantity": {
                "description": "The quantity of base currency bought or sold",
                "type": "number",
                "format": "double"
              },
              "limit_price": {
                "description": "The limit price of the order bought or sold",
                "type": "number",
                "format": "double"
              },
              "stop_price": {
                "description": "The stop price of the order bought or sold",
                "type": "number",
                "format": "double"
              },
              "time_in_force": {
                "$ref": "#/components/requestParameters/TimeInForce"
              }
            }
          }
        }
      },
      "QuoteBook": {
        "type": "object",
        "properties": {
          "symbol": {
            "title": "Symbol",
            "description": "Currency pair symbol",
            "type": "string"
          },
          "bids": {
            "title": "Bids",
            "description": "List of price / quantity tuples, sorted by decreasing price. Represents our available liquidity for sell orders.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/QuoteBookItem"
            }
          },
          "asks": {
            "title": "Asks",
            "description": "List of price / quantity tuples, sorted by increasing price. Represents our available liquidity for buy orders.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/QuoteBookItem"
            }
          },
          "timestamp": {
            "title": "Timestamp",
            "description": "The timestamp of when the price was retrieved from our system",
            "type": "string"
          }
        }
      },
      "QuoteBookItem": {
        "type": "object",
        "properties": {
          "price": {
            "title": "Price",
            "description": "The price of the order",
            "type": "number",
            "format": "double"
          },
          "quantity": {
            "title": "Quantity",
            "description": "The quantity of the order",
            "type": "number",
            "format": "double"
          }
        }
      },
      "OrderExecution": {
        "properties": {
          "effective_price": {
            "format": "decimal",
            "title": "Effective price",
            "type": "string"
          },
          "quantity": {
            "format": "decimal",
            "title": "Quantity",
            "type": "string"
          },
          "timestamp": {
            "format": "date-time",
            "title": "Timestamp",
            "type": "string"
          }
        },
        "required": [
          "effective_price",
          "quantity",
          "timestamp"
        ],
        "type": "object"
      }
    },
    "securitySchemes": {
      "API Key": {
        "type": "apiKey",
        "description": "The \"`x-api-key`\" header should contain your API key. This API key is obtained from your [crypto account settings](https://robinhood.com/account/crypto) when enrolling in the Robinhood Crypto Trading API program.\n\n****API keys issued after August 13, 2024 will be formatted as \"`rh-api-[uuid]`.\" Functionality will remain the same, and older keys will keep the original formatting (no \"`rh-api`\" prepend).***",
        "name": "x-api-key",
        "in": "header"
      },
      "API Signature": {
        "type": "apiKey",
        "description": "Authenticated requests should be signed with the \"`x-signature`\" header, using a signature generated with the following: private key, API key, timestamp, path, method, and body.\n Here’s how the message signature should be defined:\n```console\nmessage = f\"{api_key}{current_timestamp}{path}{method}{body}\"\n```\n****Note that for requests without a body, the body can be omitted from the message signature.***\n\n### Example Signature\n\nThe following is an example of a signature that corresponds to a cancel order request. You may use the example values below to ensure your code implementation is generating the same (`x-signature`) header signature value. The code snippet is for generating the signature in Python.\n\n| Field | Value |\n|-|-|\n| Private Key | xQnTJVeQLmw1/Mg2YimEViSpw/SdJcgNXZ5kQkAXNPU= |\n| Public Key | jPItx4TLjcnSUnmnXQQyAKL4eJj3+oWNNMmmm2vATqk= |\n| API Key | rh-api-6148effc-c0b1-486c-8940-a1d099456be6 |\n| Method | POST |\n| Path | /api/v1/crypto/trading/orders/ |\n| Body | {\"client_order_id\":\"131de903-5a9c-4260-abc1-28d562a5dcf0\",\"side\":\"buy\",\"type\":\"market\",\"symbol\":\"BTC-USD\",\"market_order_config\":{\"asset_quantity\":\"0.1\"}} |\n| Timestamp |  1698708981 |\n| __API Signature Header__ | __q/nEtxp/P2Or3hph3KejBqnw5o9qeuQ+hYRnB56FaHbjDsNUY9KhB1asMxohDnzdVFSD7StaTqjSd9U9HvaRAw==__ |\n\n### Code Example\n\n#### Python\n```python\nimport nacl.signing\nimport base64\nimport time\n\n# Replace these with your base64-encoded keys\nprivate_key_base64 = \"xQnTJVeQLmw1/Mg2YimEViSpw/SdJcgNXZ5kQkAXNPU=\"\npublic_key_base64 = \"jPItx4TLjcnSUnmnXQQyAKL4eJj3+oWNNMmmm2vATqk=\"\n\napi_key = \"rh-api-6148effc-c0b1-486c-8940-a1d099456be6\"\n\n# Get the current Unix timestamp in seconds\n# You can get the current_timestamp with the following code:\n# current_timestamp = int(time.time())\n# This value is hardcoded for demonstration purposes to match the example in the documentation\ncurrent_timestamp = \"1698708981\"\n\npath = f\"/api/v1/crypto/trading/orders/\"\n\nmethod = \"POST\"\n\nbody = {\n    \"client_order_id\": \"131de903-5a9c-4260-abc1-28d562a5dcf0\",\n    \"side\": \"buy\",\n    \"symbol\": \"BTC-USD\",\n    \"type\": \"market\",\n    \"market_order_config\": {\n        \"asset_quantity\": \"0.1\"\n    },\n}\n\n# Convert base64 strings to seed (for private key) and bytes (for public key)\nprivate_key_seed = base64.b64decode(private_key_base64)\npublic_key_bytes = base64.b64decode(public_key_base64)\n\n# Create private key (from seed) and public key (from bytes)\nprivate_key = nacl.signing.SigningKey(private_key_seed)\npublic_key = nacl.signing.VerifyKey(public_key_bytes)\n\n# Create the message to sign\nmessage = f\"{api_key}{current_timestamp}{path}{method}{body}\"\n\n# Sign the message\nsigned = private_key.sign(message.encode(\"utf-8\"))\n\nbase64_signature = base64.b64encode(signed.signature).decode(\"utf-8\")\nprint(base64_signature)\n\n# Verify the signature\npublic_key.verify(signed.message, signed.signature)\n\n\n```",
        "name": "x-signature",
        "in": "header"
      },
      "Timestamp": {
        "type": "apiKey",
        "description": "The \"`x-timestamp`\" header should contain the timestamp of the request.\n\n**To protect the security and integrity of your API interactions, timestamps are only valid for 30 seconds after they’re generated, and an expired timestamp will be rejected. Therefore, ensure that your requests are made promptly after generating the timestamp.**\n\nBelow is an example in Python on how to generate the timestamp. \n\n```python\nimport time\n\ncurrent_timestamp = int(time.time())\nprint(current_timestamp)\n```",
        "name": "x-timestamp",
        "in": "header"
      }
    }
  },
  "x-tagGroups": [
    {
      "name": "V2 Endpoints (with Fee Tiers)",
      "tags": [
        "V2 Account",
        "V2 Market Data",
        "V2 Trading"
      ]
    },
    {
      "name": "V1 Endpoints (without Fee Tiers)",
      "tags": [
        "Account",
        "Market Data",
        "Trading"
      ]
    }
  ]
}