> ## Documentation Index > Fetch the complete documentation index at: https://docs.tradingapi.dev/llms.txt > Use this file to discover all available pages before exploring further. # Get a market > Returns one market. The symbol is case-insensitive. An unknown symbol returns `404 market_not_found` with the closest matches in `details.suggestions`. ## OpenAPI ````yaml /openapi.yaml get /v1/markets/{symbol} openapi: 3.1.0 info: title: Trading API license: name: Proprietary identifier: LicenseRef-Proprietary version: '1' summary: Trade perpetual futures on Hyperliquid with plain HTTP requests. description: > The Trading API places market orders on Hyperliquid perpetual futures and reports your positions, fills and balance. You never sign anything, manage nonces or look up asset indexes: send a market, a side and a value in US dollars. Every request authenticates with an API key created on the account page: `Authorization: Bearer tapi_…`. servers: - url: https://tradingapi.dev description: Production. Orders trade real money on Hyperliquid mainnet. security: - apiKey: [] tags: - name: Markets description: The markets you can trade, with their rules and current prices. - name: Orders description: Place, preview, list and look up orders. - name: Positions description: Your open positions, and closing them. - name: Account description: Your balance, the calling key, fills and withdrawals. paths: /v1/markets/{symbol}: get: tags: - Markets summary: Get a market description: > Returns one market. The symbol is case-insensitive. An unknown symbol returns `404 market_not_found` with the closest matches in `details.suggestions`. operationId: getMarket parameters: - $ref: '#/components/parameters/MarketSymbol' responses: '200': description: The market. content: application/json: schema: $ref: '#/components/schemas/Market' examples: btc: summary: BTC value: object: market symbol: BTC name: Bitcoin category: crypto status: open size_increment: '0.00001' min_value: '10.00' max_value: '25.00' price: '84034.9' funding_rate_hourly: '0.0000125' '401': $ref: '#/components/responses/Unauthorized' '404': description: No market has this symbol. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: market_not_found: value: error: type: not_found code: market_not_found message: There is no market called "TESLA". param: symbol hint: >- Did you mean TSLA (Tesla)? Orders need the exact symbol; GET /v1/markets?q=tesla lists matches. details: suggestions: - symbol: TSLA name: Tesla errors: [] retryable: false doc_url: >- https://docs.tradingapi.dev/api-reference/errors#market_not_found '429': $ref: '#/components/responses/RateLimited' '503': $ref: '#/components/responses/Unavailable' components: parameters: MarketSymbol: name: symbol in: path required: true description: >- A market symbol from `GET /v1/markets`, for example `BTC` or `TSLA`. Case-insensitive. schema: type: string schemas: Market: type: object required: - object - symbol - name - category - status - size_increment - min_value - max_value - price - funding_rate_hourly properties: object: type: string const: market symbol: type: string description: >- The market's identifier everywhere in the API, for example `BTC` or `TSLA`. name: type: string description: A human-readable name, for example `Bitcoin` or `Tesla`. category: type: string enum: - crypto - equity - index - commodity - fx status: type: string enum: - open - reduce_only - halted description: >- `open`: all orders accepted. `reduce_only`: only orders that reduce a position. `halted`: no orders. size_increment: $ref: '#/components/schemas/Decimal' description: >- Sizes are multiples of this. Orders sized by value are rounded down to it. min_value: $ref: '#/components/schemas/Usd' description: >- The smallest order, in USD, after rounding. Closing a whole position is exempt. max_value: $ref: '#/components/schemas/Usd' description: >- The largest order, in USD. Your key may have a lower limit; see `GET /v1/api_key`. price: $ref: '#/components/schemas/Decimal' description: >- The current mark price, used for your positions' value and profit and loss. funding_rate_hourly: $ref: '#/components/schemas/Decimal' description: >- The current hourly funding rate as a fraction. Positive means longs pay shorts. ErrorResponse: type: object required: - error properties: error: $ref: '#/components/schemas/Error' Decimal: type: string description: >- A decimal number as a string, for example `"250.00"`. Requests also accept a JSON number. pattern: ^-?[0-9]+(\.[0-9]+)?$ Usd: type: string description: US dollars as a decimal string, for example `"248.68"`. pattern: ^-?[0-9]+(\.[0-9]+)?$ Error: type: object required: - type - code - message - param - hint - details - errors - retryable - doc_url properties: type: type: string enum: - invalid_request - authentication - permission - not_found - conflict - unprocessable - rate_limited - unavailable - internal description: The kind of error. It determines the HTTP status. code: type: string description: >- A stable identifier for the error. Branch on this. New codes may be added. message: type: string description: What was wrong, with the values involved. param: type: - string - 'null' description: The request field at fault, as a JSON path, or `null`. hint: type: - string - 'null' description: One concrete way to fix the request. details: type: object description: The numbers and values the message refers to, as fields. additionalProperties: true errors: type: array description: Every field error, when `code` is `invalid_fields`. Empty otherwise. items: $ref: '#/components/schemas/Error' retryable: type: boolean description: Whether the same request can succeed later, unchanged. retry_after: $ref: '#/components/schemas/Timestamp' description: When a retry can succeed, if known. doc_url: type: string format: uri Timestamp: type: string format: date-time description: >- RFC 3339 in UTC with milliseconds, for example `2026-09-27T14:30:00.123Z`. responses: Unauthorized: description: No valid API key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_api_key: value: error: type: authentication code: invalid_api_key message: This API key is not valid. It may have been revoked. param: null hint: >- Send a current key as Authorization: Bearer tapi_…. Keys are created and revoked on the account page. details: {} errors: [] retryable: false doc_url: >- https://docs.tradingapi.dev/api-reference/errors#invalid_api_key RateLimited: description: >- The key made too many requests. Each key may make 10 requests at once, then 5 a second. Nothing was done; retry after `Retry-After` seconds. headers: Retry-After: description: The seconds to wait before retrying, always `1`. schema: type: string enum: - '1' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: rate_limited: value: error: type: rate_limited code: rate_limited message: This key made too many requests; retry in 1 s. param: null hint: >- Slow down: each key may make 10 requests at once, then 5 a second. details: {} errors: [] retryable: true retry_after: '2026-09-28T14:05:12.000Z' doc_url: >- https://docs.tradingapi.dev/api-reference/errors#rate_limited Unavailable: description: A service we depend on failed. Retry the same request. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unavailable: value: error: type: unavailable code: unavailable message: The exchange could not be reached. param: null hint: >- Retry the same request with the same client_order_id; an order may already have been recorded. details: {} errors: [] retryable: true doc_url: https://docs.tradingapi.dev/api-reference/errors#unavailable securitySchemes: apiKey: type: http scheme: bearer bearerFormat: tapi_… description: >- An API key from the account page, sent as `Authorization: Bearer tapi_…`. ````