> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sharpe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CEX spot-transfer arbitrage scanner

> Returns live CEX spot-transfer arbitrage routes after exact network matching (ambiguous network names are refused), token-contract matching, withdrawal/deposit status and minimums, withdrawal fees, per-venue taker fees, executable depth and slippage. Routes netting above zero come first; up to 50 near-miss routes that do not clear fees follow as indicative (`below_fees`). `meta.transferScan` counts the coins, venues and routes the scan evaluated. Same-ticker contract mismatches fail closed.



## OpenAPI

````yaml /openapi.json get /v1/arbitrage/cex-spot-transfer
openapi: 3.0.0
info:
  title: Sharpe API
  version: 1.0.0
  description: >-
    Institutional-grade crypto market data API. Access funding rates, futures,
    arbitrage opportunities, narratives, ecosystems, and more.


    Authentication is supported via two production-safe methods:

    1. **Bearer token** in the Authorization header: `Authorization: Bearer
    sk_live_...`

    2. **X-API-Key header**: `X-API-Key: sk_live_...`


    API keys in query parameters are rejected by default because URLs are
    commonly stored in logs, browser history, analytics tools, and referrer
    headers.


    These `/v1` endpoints send no CORS headers and must be called from a server:
    calling them from a browser would expose your API key in page JavaScript.


    Every endpoint needs an API key, except `/v1/health` and
    `/v1/meta/coverage`. A key works on a paid plan
    (https://www.sharpe.ai/pricing) or during its account's one-time trial of 7
    days and 250 requests; otherwise it answers 401 `expired_api_key`. There is
    no free API tier and no keyless API.
  contact:
    name: Sharpe API Support
    url: https://sharpe.ai
    email: team@sharpe.ai
servers:
  - url: https://www.sharpe.ai/api
    description: Production
security:
  - BearerAuth: []
  - ApiKeyAuth: []
tags:
  - name: System
    description: Health checks and service status
  - name: Account
    description: API key usage and quota information
  - name: Derivatives
    description: Funding rates and futures data
  - name: Market Data
    description: >-
      Heatmaps, correlations, tracker, price predictions, news, gem finder, and
      market cap search
  - name: Arbitrage
    description: >-
      Spot-perp, cross-exchange, dated futures basis, calendar spread,
      perp-dated carry, and transfer arbitrage scanners
  - name: Categories
    description: Narratives, ecosystems, and memecoins data
  - name: New Listings
    description: >-
      Spot listings, Perp listings, delistings, suspensions, scheduled trading
      starts, exchange pages, and narrative flow across CEXs and Perp DEXs.
  - name: Screener
    description: Rug Check security, holders, resolve and trending endpoints.
  - name: Signals
    description: >-
      Composite signal scores derived from cross-exchange derivatives data:
      insider selling pressure and pump-and-dump detection.
  - name: Reports
    description: >-
      Markdown reports rendered on the server from the endpoints above: the
      market briefing, one coin's analysis, and the funding-arbitrage
      opportunities.
paths:
  /v1/arbitrage/cex-spot-transfer:
    get:
      tags:
        - Arbitrage
      summary: CEX spot-transfer arbitrage scanner
      description: >-
        Returns live CEX spot-transfer arbitrage routes after exact network
        matching (ambiguous network names are refused), token-contract matching,
        withdrawal/deposit status and minimums, withdrawal fees, per-venue taker
        fees, executable depth and slippage. Routes netting above zero come
        first; up to 50 near-miss routes that do not clear fees follow as
        indicative (`below_fees`). `meta.transferScan` counts the coins, venues
        and routes the scan evaluated. Same-ticker contract mismatches fail
        closed.
      operationId: getArbitrageCexSpotTransfer
      parameters:
        - $ref: '#/components/parameters/ArbitrageCoinParam'
        - $ref: '#/components/parameters/ArbitrageExchangesParam'
        - $ref: '#/components/parameters/ArbitrageMinNetParam'
        - $ref: '#/components/parameters/ArbitrageMinDepthUsdParam'
        - $ref: '#/components/parameters/ArbitrageNotionalParam'
        - $ref: '#/components/parameters/LimitParam'
        - $ref: '#/components/parameters/CursorParam'
        - $ref: '#/components/parameters/FormatParam'
      responses:
        '200':
          description: >-
            CEX spot-transfer scanner rows (executable and indicative) returned
            successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CexSpotTransferResponse'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
            X-Quota-Limit:
              $ref: '#/components/headers/X-Quota-Limit'
            X-Quota-Remaining:
              $ref: '#/components/headers/X-Quota-Remaining'
            X-Quota-Reset:
              $ref: '#/components/headers/X-Quota-Reset'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
components:
  parameters:
    ArbitrageCoinParam:
      name: coin
      in: query
      description: Optional base coin ticker, for example BTC, ETH, or SOL.
      schema:
        type: string
        minLength: 1
    ArbitrageExchangesParam:
      name: exchanges
      in: query
      description: Comma-separated exchange filter, for example Binance,Bybit,OKX.
      schema:
        type: string
    ArbitrageMinNetParam:
      name: minNet
      in: query
      description: >-
        Minimum of the board's net figure, as a fraction (0.05 is 5%): `netApr`
        on the dated basis board, `netRollApy` on the calendar board,
        `netCarryApr` (the fee-adjusted annualized net carry, not the edge to
        expiry) on the perp-dated carry board, `netReturn` (per trip, not
        annualized) on the CEX transfer board.
      schema:
        type: number
    ArbitrageMinDepthUsdParam:
      name: minDepthUsd
      in: query
      description: Minimum executable depth in USD when available.
      schema:
        type: number
        minimum: 0
    ArbitrageNotionalParam:
      name: notional
      in: query
      description: >-
        Position notional in USD. On the dated-futures basis, calendar-spread
        and perp-dated carry scanners a row is executable only when its book
        depth (level 1 on the stored snapshot; on a live read a top-20 walk
        where level 1 is thin, the side then priced at that walk's VWAP), any
        reported open interest and its 24h volume are at least this notional
        (and its quotes are at most 10 minutes old). The CEX spot transfer
        scanner sizes its order-book fills with it.
      schema:
        default: 10000
        type: number
        minimum: 0
        exclusiveMinimum: true
        maximum: 1000000000
    LimitParam:
      name: limit
      in: query
      description: Maximum number of rows returned.
      schema:
        default: 100
        type: integer
        minimum: 1
        maximum: 1000
    CursorParam:
      name: cursor
      in: query
      description: Opaque cursor from the previous page.
      schema:
        type: string
    FormatParam:
      name: format
      in: query
      description: >-
        Response format. When set to "csv", the response Content-Type is
        text/csv instead of JSON.
      schema:
        default: json
        type: string
        enum:
          - json
          - csv
  schemas:
    CexSpotTransferResponse:
      allOf:
        - $ref: '#/components/schemas/SuccessEnvelope'
        - type: object
          properties:
            data:
              type: object
              properties:
                rows:
                  type: array
                  items:
                    $ref: '#/components/schemas/CexSpotTransferRow'
                scannerMeta:
                  $ref: '#/components/schemas/ScannerMeta'
                pagination:
                  nullable: true
                  allOf:
                    - $ref: '#/components/schemas/PaginationInfo'
              required:
                - rows
                - scannerMeta
                - pagination
          required:
            - data
    SuccessEnvelope:
      type: object
      properties:
        data:
          description: >-
            Endpoint-specific response payload. See the operation response
            schema.
        meta:
          $ref: '#/components/schemas/ApiMeta'
      required:
        - data
        - meta
    CexSpotTransferRow:
      type: object
      properties:
        rank:
          type: integer
        coin:
          type: string
        buyExchange:
          type: string
        sellExchange:
          type: string
        buyAsk:
          type: number
        sellBid:
          type: number
        grossSpread:
          type: number
        network:
          type: string
        contractAddress:
          nullable: true
          type: string
        withdrawFee:
          type: number
        depositStatus:
          type: string
          enum:
            - Open
            - Closed
        withdrawStatus:
          type: string
          enum:
            - Open
            - Closed
        transferEta:
          type: string
          description: >-
            Deprecated: `transferConfirmations` as a label ("15 confs"), not a
            time.
        transferConfirmations:
          nullable: true
          description: >-
            Deposit confirmations the sell venue waits for on the route's
            network; null when it does not report them.
          type: integer
        depthUsd:
          nullable: true
          type: number
        slippage:
          nullable: true
          type: number
        netReturn:
          nullable: true
          description: >-
            [VWAP_sell(q - withdrawFee) x (1 - sellTakerFee) - N x (1 +
            buyTakerFee)] / N, a fraction of the notional N per trip, not
            annualized (0.001 is 0.1%). At or below zero on near-miss rows
            (`indicativeReason: below_fees`).
          type: number
        buyTakerFee:
          type: number
          description: >-
            Spot taker fee charged on the buy fill, a fraction (0.001 is 0.1%):
            the venue catalog's own when it reports one, else the shared venue
            fee table.
        sellTakerFee:
          type: number
        spreadLifetimeSeconds:
          nullable: true
          description: >-
            How long this server instance has seen the route continuously;
            resets on a cold start or another instance.
          type: number
        updatedAt:
          type: string
          format: date-time
          description: The older of the two order books (quote time).
        networkUpdatedAt:
          type: string
          format: date-time
          description: The older of the two venues' transfer-network reads.
        isStale:
          type: boolean
          description: >-
            An order book older than the 60 s quote SLA, or a transfer-network
            read older than 10 minutes.
        executionStatus:
          type: string
          enum:
            - executable
            - indicative
          description: >-
            Executable: fresh books and networks, both books fill the notional,
            net profit above zero.
        indicativeReason:
          nullable: true
          type: string
          enum:
            - below_fees
            - stale_quote
            - stale_network
      required:
        - rank
        - coin
        - buyExchange
        - sellExchange
        - buyAsk
        - sellBid
        - grossSpread
        - network
        - contractAddress
        - withdrawFee
        - depositStatus
        - withdrawStatus
        - transferEta
        - transferConfirmations
        - depthUsd
        - slippage
        - netReturn
        - buyTakerFee
        - sellTakerFee
        - spreadLifetimeSeconds
        - updatedAt
        - networkUpdatedAt
        - isStale
        - executionStatus
        - indicativeReason
    ScannerMeta:
      type: object
      properties:
        kind:
          type: string
          enum:
            - dated-futures-basis
            - futures-calendar-spread
            - perp-dated-carry
            - cex-spot-transfer
        status:
          type: string
          enum:
            - ok
            - unavailable
        generatedAt:
          type: string
          format: date-time
        updatedAt:
          nullable: true
          type: string
          format: date-time
        stale:
          type: boolean
          description: >-
            True when `updatedAt` is older than `freshnessSlaSeconds`. Each row
            carries its own `isStale` by the same threshold.
        freshnessSlaSeconds:
          type: integer
          description: >-
            Seconds a row's snapshot stays fresh: 7,200 on the dated basis,
            calendar and carry boards (the term-structure SLA; the envelope's
            `freshness_sla_seconds` is 7,200 when the hourly term structure
            answered and 600 when the 5-minute dated-quotes snapshot did, its
            `dataset_id` says which), 60 on the CEX transfer board (its order
            books, the envelope's `freshness_sla_seconds`; transfer networks are
            judged on 10 minutes per row).
        source:
          type: string
          enum:
            - supabase
            - supabase-stale
            - live
            - unavailable
          description: >-
            Where the board's rows came from: the stored hourly term-structure
            snapshot, a stored snapshot past its SLA, the venues read live (on
            request, or by the 5-minute dated-quotes snapshot the
            arbitrage-boards cron writes: then the envelope's `dataset_id` is
            `arbitrage_dated_quotes` and `served_from` is `snapshot`; always
            `live` on the CEX transfer board), or nothing. The upstream source
            ids are in the X-Data-Source header.
        notionalUsd:
          type: number
        rowCount:
          type: integer
        supportedCoins:
          type: array
          items:
            type: string
          description: >-
            The coins the board covers: the supported basis coins on the dated
            boards; the coins the scan fetched on the CEX transfer board.
        warnings:
          type: array
          items:
            type: string
        transferScan:
          $ref: '#/components/schemas/CexTransferScan'
      required:
        - kind
        - status
        - generatedAt
        - updatedAt
        - stale
        - freshnessSlaSeconds
        - source
        - notionalUsd
        - rowCount
        - supportedCoins
        - warnings
    PaginationInfo:
      type: object
      properties:
        cursor:
          nullable: true
          type: string
        has_more:
          type: boolean
        total:
          type: integer
          minimum: 0
      required:
        - cursor
        - has_more
        - total
    ErrorResponse:
      type: object
      properties:
        type:
          type: string
          format: uri
          description: URI identifying the error type.
          example: https://www.sharpe.ai/errors/invalid_parameter
        title:
          type: string
          description: Short human-readable summary.
          example: Invalid Parameter
        status:
          type: integer
          description: HTTP status code.
          example: 400
        detail:
          type: string
          description: Human-readable explanation specific to this occurrence.
          example: 'Invalid parameter "coin": must not be empty'
        request_id:
          type: string
          description: Unique request identifier for support reference.
          example: req_a1b2c3d4e5f6g7h8i9j0
        doc_url:
          type: string
          format: uri
          description: Link to the relevant documentation page for troubleshooting.
          example: https://www.sharpe.ai/docs/errors#error-codes
        suggested_action:
          type: string
          description: Actionable suggestion for resolving the error.
          example: >-
            Check the 'coin' parameter value and ensure it is a valid ticker
            symbol.
      required:
        - type
        - title
        - status
        - detail
        - request_id
        - doc_url
        - suggested_action
      description: Error response following RFC 9457 (Problem Details for HTTP APIs).
    ApiMeta:
      type: object
      properties:
        request_id:
          type: string
          description: Unique request identifier.
          example: req_a1b2c3d4e5f6g7h8i9j0
        timestamp:
          type: string
          format: date-time
          description: ISO 8601 timestamp of the response.
        elapsed_ms:
          type: integer
          minimum: 0
          description: Server processing time in milliseconds.
        dataset_id:
          type: string
          enum:
            - funding_rates_current
            - funding_rates_history
            - funding_accumulated
            - funding_fee_settlement
            - global_overview_snapshot
            - futures_open_interest
            - futures_basis
            - futures_term_structure
            - futures_liquidations
            - futures_long_short_ratio
            - futures_ohlcv
            - futures_coins
            - rwa_perp_rates_current
            - arbitrage_tickers
            - arbitrage_boards
            - arbitrage_dated_quotes
            - narratives
            - ecosystems
            - memecoins
            - mindshare
            - sectors
            - chains
            - sector_coins
            - chain_coins
            - gem_finder
            - web_traffic
            - heatmap_cache
            - stablecoins
            - news
            - listings
            - memecoin_launches
            - rug_check_inputs
            - rug_check_trending
            - pump_dump
            - insider_pressure
            - price_prediction_inputs
            - correlation_prices
            - market_cap_search
            - coingecko_coin_list
            - boros_markets
            - margin_borrow_rates
          description: >-
            The dataset the answer is read from; /v1/meta/coverage lists each
            product's datasets with their cadence and SLA.
        as_of:
          nullable: true
          type: string
          format: date-time
          description: >-
            When the data was current: the dataset's own time (the newest live
            row, the snapshot or refresh time, the fetch time), not the response
            time. Null when unknown.
        stale_after:
          nullable: true
          type: string
          format: date-time
          description: >-
            `as_of` plus the freshness SLA: after this instant the data is
            stale, whenever the body is read (a cached copy can be re-judged
            against it).
        freshness_sla_seconds:
          type: number
          description: >-
            Seconds after `as_of` the data stays fresh: the writer's cadence
            plus one skipped run.
        freshness_status:
          type: string
          enum:
            - fresh
            - stale
            - unknown
          description: >-
            `fresh` within the SLA at `generated_at`, `stale` past it, `unknown`
            when `as_of` is null.
        runtime_status:
          type: string
          enum:
            - ok
            - degraded
          description: >-
            `degraded` when this read was incomplete: a leg timed out or failed,
            a row budget was hit, or a fallback answered. Degraded answers are
            never cached.
        served_from:
          type: string
          enum:
            - snapshot
            - table
            - matview
            - live
            - last-good
          description: >-
            Where the rows came from: a precomputed snapshot, a table or
            materialized view, the upstream on request, or the server's last
            good answer.
        generated_at:
          type: string
          format: date-time
          description: >-
            When this answer was built (the instant `freshness_status` is judged
            at).
        source:
          type: array
          items:
            type: string
          description: >-
            The upstream sources behind the rows (source ids such as `binance`,
            `coingecko`).
        coverage:
          type: object
          properties:
            expected:
              type: number
            used:
              type: number
            dropped:
              type: object
              additionalProperties:
                type: number
            missing:
              type: array
              items:
                type: string
          required:
            - expected
            - used
            - dropped
          description: >-
            How complete the stored data is (never whether it is cached): `used`
            of `expected` inputs counted; `dropped` counts the rest by reason (a
            halted market is `not_live`, outside `expected`); `missing` names
            the late ones when known.
        warnings:
          type: array
          items:
            type: string
          description: >-
            What the read could not do, in words (an unreadable table, a late
            writer).
        truncated:
          type: boolean
          description: True when a row budget cut the answer short.
      required:
        - request_id
        - timestamp
        - elapsed_ms
    CexTransferScan:
      type: object
      properties:
        coinsScanned:
          type: integer
        scannedCoins:
          type: array
          items:
            type: string
        venuesAnswering:
          type: integer
          description: >-
            Selected venues that returned at least one order book and one
            transfer network.
        venues:
          type: array
          items:
            type: object
            properties:
              exchange:
                type: string
              status:
                type: string
                enum:
                  - ok
                  - not_live
                  - no_books
                  - no_networks
                  - failed
                description: >-
                  not_live: the venue's public spot ticker shows no live book
                  (left out of coverage); failed/no_books/no_networks make the
                  answer degraded.
            required:
              - exchange
              - status
        routesEvaluated:
          type: integer
          description: >-
            Directed (coin, buy venue, sell venue) routes with a computed net:
            both books fill the notional on one common open network.
        routesProfitable:
          type: integer
          description: Evaluated routes netting above zero after fees.
        bestNetReturn:
          nullable: true
          description: >-
            Best `netReturn` over evaluated routes, a fraction of the notional
            per trip (0.001 is 0.1%); null when none was evaluated.
          type: number
      required:
        - coinsScanned
        - scannedCoins
        - venuesAnswering
        - venues
        - routesEvaluated
        - routesProfitable
        - bestNetReturn
  headers:
    X-Request-Id:
      schema:
        type: string
      description: Unique request identifier. Include this value when contacting support.
    X-RateLimit-Limit:
      schema:
        type: integer
      description: Requests allowed per minute for the authenticated API key.
    X-RateLimit-Remaining:
      schema:
        type: integer
      description: Requests remaining in the current one-minute rate-limit window.
    X-RateLimit-Reset:
      schema:
        type: integer
      description: Unix timestamp in seconds when the current rate-limit window resets.
    X-Quota-Limit:
      schema:
        type: integer
      description: Monthly request quota for the authenticated API key.
    X-Quota-Remaining:
      schema:
        type: integer
      description: Monthly requests remaining in the current billing period.
    X-Quota-Reset:
      schema:
        type: string
        format: date-time
      description: >-
        ISO 8601 timestamp when the monthly quota resets, when available from
        the quota store.
    Retry-After:
      schema:
        type: integer
      description: >-
        Seconds to wait before retrying after a per-minute rate-limit or
        monthly-quota rejection.
  responses:
    BadRequest:
      description: Invalid or missing parameter.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            type: https://www.sharpe.ai/errors/invalid_parameter
            title: Invalid Parameter
            status: 400
            detail: 'Invalid parameter "coin": must not be empty'
            request_id: req_a1b2c3d4e5f6g7h8i9j0
            doc_url: https://www.sharpe.ai/docs/errors#error-codes
            suggested_action: >-
              Check the parameter value against the endpoint documentation. Use
              GET /v1/futures/coins or GET /v1/meta/coverage to discover valid
              values.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
    Unauthorized:
      description: >-
        Missing or invalid API key, or a key without an active plan
        (`expired_api_key`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            invalid_api_key:
              summary: Missing or invalid API key
              value:
                type: https://www.sharpe.ai/errors/invalid_api_key
                title: Invalid API Key
                status: 401
                detail: >-
                  Missing API key. Pass via Authorization: Bearer <key> or the
                  X-API-Key header.
                request_id: req_a1b2c3d4e5f6g7h8i9j0
                doc_url: https://www.sharpe.ai/docs/authentication
                suggested_action: >-
                  Check your API key is correct. Pass it via Authorization:
                  Bearer <key> or the X-API-Key header.
            expired_api_key:
              summary: The key has no active plan
              value:
                type: https://www.sharpe.ai/errors/expired_api_key
                title: Expired API Key
                status: 401
                detail: >-
                  This API key has no active plan. Subscribe or renew at
                  https://www.sharpe.ai/dashboard/billing.
                request_id: req_a1b2c3d4e5f6g7h8i9j0
                doc_url: https://www.sharpe.ai/docs/authentication
                suggested_action: >-
                  Subscribe or renew at https://www.sharpe.ai/dashboard/billing.
                  The same key works again once the plan is active.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
    Forbidden:
      description: The API key lacks a scope this endpoint requires.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            type: https://www.sharpe.ai/errors/insufficient_scope
            title: Insufficient Scope
            status: 403
            detail: 'This API key requires the following scope(s): read.'
            request_id: req_a1b2c3d4e5f6g7h8i9j0
            doc_url: https://www.sharpe.ai/docs/authentication
            suggested_action: >-
              Create a new API key with the required scopes, or contact support
              to update scopes on your existing key.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
    RateLimited:
      description: >-
        Per-minute rate limit or monthly quota exceeded. Both are temporary;
        retry after the Retry-After header.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            rate_limit_exceeded:
              summary: Per-minute rate limit exceeded
              value:
                type: https://www.sharpe.ai/errors/rate_limit_exceeded
                title: Rate Limit Exceeded
                status: 429
                detail: Rate limit of 30 requests per minute exceeded.
                request_id: req_a1b2c3d4e5f6g7h8i9j0
                doc_url: https://www.sharpe.ai/docs/rate-limits
                suggested_action: >-
                  Wait until the time in the X-RateLimit-Reset header before
                  retrying. Upgrade your plan for higher limits.
            monthly_quota_exceeded:
              summary: Monthly quota exceeded
              value:
                type: https://www.sharpe.ai/errors/monthly_quota_exceeded
                title: Monthly Quota Exceeded
                status: 429
                detail: >-
                  Monthly quota of 50,000 requests exceeded. Resets at
                  2026-12-01T00:00:00.000Z.
                request_id: req_a1b2c3d4e5f6g7h8i9j0
                doc_url: https://www.sharpe.ai/docs/rate-limits
                suggested_action: >-
                  Retry after the seconds given in the Retry-After header, when
                  the monthly quota resets. Upgrade your plan for a higher
                  monthly quota. Check usage at GET /v1/usage.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
        X-Quota-Limit:
          $ref: '#/components/headers/X-Quota-Limit'
        X-Quota-Remaining:
          $ref: '#/components/headers/X-Quota-Remaining'
        X-Quota-Reset:
          $ref: '#/components/headers/X-Quota-Reset'
        Retry-After:
          $ref: '#/components/headers/Retry-After'
    InternalError:
      description: Unexpected server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            type: https://www.sharpe.ai/errors/internal_error
            title: Internal Server Error
            status: 500
            detail: An unexpected error occurred. Please try again later.
            request_id: req_a1b2c3d4e5f6g7h8i9j0
            doc_url: https://www.sharpe.ai/docs/errors#retry-guidance
            suggested_action: >-
              Retry with exponential backoff (1s, 2s, 4s, up to 30s). If the
              error persists, contact support with the X-Request-Id.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
    ServiceUnavailable:
      description: The API or quota verification service is temporarily unavailable.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            type: https://www.sharpe.ai/errors/service_unavailable
            title: Service Unavailable
            status: 503
            detail: >-
              API key verification is temporarily unavailable. Please retry
              shortly.
            request_id: req_a1b2c3d4e5f6g7h8i9j0
            doc_url: https://www.sharpe.ai/docs/errors#retry-guidance
            suggested_action: >-
              The API is temporarily unavailable. Retry with exponential
              backoff. If it persists, contact team@sharpe.ai with the
              X-Request-Id.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Pass your API key as a Bearer token in the Authorization header:
        `Authorization: Bearer sk_live_...`
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Alternatively, pass your API key via the X-API-Key header.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.