Dwellir API

openapi: 3.1.0
info:
  title: Dwellir API
  version: '2026-11-02'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-02: 19 operation(s) read from 40 public documentation page(s) (each
    operation names its page in x-source). This is not the provider''s published contract; Dwellir has published no machine-readable contract
    that the pipeline could find. Engine: oss.'
  x-evidence-tiers:
    code-example: 13
    documentation: 6
    pages-with-code: 39
    pages-read: 40
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-02'
  x-generator: generate-contract-from-docs.py
  x-engine: oss
  x-sources:
  - https://www.dwellir.com/api/docs/getting-started/markdown
  - https://www.dwellir.com/docs/acala
  - https://www.dwellir.com/docs/ronin
  - https://www.dwellir.com/docs/taiko
  - https://www.dwellir.com/docs/chiliz
  - https://www.dwellir.com/docs/kusama
  - https://www.dwellir.com/docs/hyperliquid
  - https://www.dwellir.com/docs/manta-pacific
  - https://www.dwellir.com/guides/kalshi-api-guide.md
  - https://www.dwellir.com/guides/polymarket-api-guide.md
  - https://www.dwellir.com/docs/getting-started/authentication
  - https://www.dwellir.com/guides/when-to-use-ip-whitelisting.md
  - https://www.dwellir.com/docs/getting-started
  - https://www.dwellir.com/docs/getting-started/tracing
  - https://www.dwellir.com/docs/getting-started/sticky-sessions
  - https://www.dwellir.com/docs/cli
  - https://www.dwellir.com/docs/cli/api-keys
  - https://www.dwellir.com/docs/cli/installation
  - https://www.dwellir.com/docs/cli/configuration
  - https://www.dwellir.com/docs/agents
  - https://www.dwellir.com/docs/aptos
  - https://www.dwellir.com/docs/arbitrum
  - https://www.dwellir.com/docs/arc
  - https://www.dwellir.com/docs/asset-hub
  - https://www.dwellir.com/docs/astar
  - https://www.dwellir.com/docs/avalanche
  - https://www.dwellir.com/docs/base
  - https://www.dwellir.com/docs/berachain
  - https://www.dwellir.com/docs/bifrost
  - https://www.dwellir.com/docs/bsc
  - https://www.dwellir.com/docs/bittensor
  - https://www.dwellir.com/docs/blast
  - https://www.dwellir.com/docs/boba-network
  - https://www.dwellir.com/docs/bridge-hub
  - https://www.dwellir.com/docs/celo
  - https://www.dwellir.com/docs/cronos
  - https://www.dwellir.com/docs/enjin
  - https://www.dwellir.com/docs/ethereum
  - https://www.dwellir.com/docs/etherlink
  - https://www.dwellir.com/docs/flow-evm-gateway
servers:
- url: https://api-ethereum-mainnet.n.dwellir.com
paths:
  /account/endpoint_costs:
    get:
      operationId: get_account_endpoint_costs
      tags:
      - Account
      summary: GET /account/endpoint_costs lists endpoints that cost more or less than 10 tokens.
      x-source: https://www.dwellir.com/guides/kalshi-api-guide.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /account/limits:
    get:
      operationId: get_account_limits
      tags:
      - Account
      summary: GET /account/limits returns your current tier and bucket sizes.
      x-source: https://www.dwellir.com/guides/kalshi-api-guide.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAccountLimitsResponse'
      x-evidence:
        kind: documentation
  /api/geoblock:
    get:
      operationId: get_api_geoblock
      tags:
      - Api
      summary: GET /api/geoblock
      x-source: https://www.dwellir.com/guides/polymarket-api-guide.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: python
        snippet: requests.get("https://polymarket.com/api/geoblock", timeout=10)
  /api_keys/generate:
    post:
      operationId: post_api_keys_generate
      tags:
      - Api Keys
      summary: POST /api_keys/generate returns a new key pair.
      x-source: https://www.dwellir.com/guides/kalshi-api-guide.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /auth/api-key:
    post:
      operationId: post_auth_api_key
      tags:
      - Auth
      summary: POST /auth/api-key
      x-source: https://www.dwellir.com/guides/polymarket-api-guide.md
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostAuthApiKeyResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -X POST "https://clob.polymarket.com/auth/api-key"  -H "POLY_ADDRESS: <signer_address>"  -H "POLY_SIGNATURE: <clob_l1_signature>"  -H
          "POLY_TIMESTAMP: <unix_seconds>"  -H "POLY_NONCE: <nonce>"'
  /auth/derive-api-key:
    get:
      operationId: get_auth_derive_api_key
      tags:
      - Auth
      summary: GET /auth/derive-api-key
      x-source: https://www.dwellir.com/guides/polymarket-api-guide.md
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAuthDeriveApiKeyResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl "https://clob.polymarket.com/auth/derive-api-key" -H "POLY_ADDRESS: ..." # same headers

          ```'
  /dwellir-public/cli/main/scripts/install.sh:
    get:
      operationId: get_dwellir_public_cli_main_scripts_install_sh
      tags:
      - Dwellir Public
      summary: GET /dwellir-public/cli/main/scripts/install.sh
      x-source: https://www.dwellir.com/api/docs/getting-started/markdown
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -fsSL https://raw.githubusercontent.com/dwellir-public/cli/main/scripts/install.sh | sh

          dwellir auth login

          dwellir keys create --name my-key

          dwellir keys copy my-key

          ```'
    post:
      operationId: post_dwellir_public_cli_main_scripts_install_sh
      tags:
      - Dwellir Public
      summary: POST /dwellir-public/cli/main/scripts/install.sh
      x-source: https://www.dwellir.com/docs/getting-started
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl, Web3.js, Ethers.js, and WebSocket quickstart examples. \n This guide helps you create an API key and make your first request\
          \ in minutes. \n For access errors, limits, historical queries, filters, regions, and account controls, see RPC troubleshooting . \n\
          \ 1. Sign Up and Get Your API Key Copy Anchor Link \n Go to dashboard.dwellir.com and sign up \n Your first API key is created automatically\
          \ -- f"
  /exchange/status:
    get:
      operationId: get_exchange_status
      tags:
      - Exchange
      summary: GET /exchange/status returns the current exchange status.
      x-source: https://www.dwellir.com/guides/kalshi-api-guide.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /historical/cutoff:
    get:
      operationId: get_historical_cutoff
      tags:
      - Historical
      summary: GET /historical/cutoff returns cutoff dates for historical data.
      x-source: https://www.dwellir.com/guides/kalshi-api-guide.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /markets/trades:
    get:
      operationId: get_markets_trades
      tags:
      - Markets
      summary: GET /markets/trades provides recent trade data.
      x-source: https://www.dwellir.com/guides/kalshi-api-guide.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /markets/{ticker}/orderbook:
    get:
      operationId: get_markets_ticker_orderbook
      tags:
      - Markets
      summary: GET /markets/{ticker}/orderbook returns the order book with yes and no bid levels.
      x-source: https://www.dwellir.com/guides/kalshi-api-guide.md
      parameters:
      - name: ticker
        in: path
        required: true
        schema:
          type: string
      - name: depth
        in: query
        required: false
        schema:
          type: integer
        description: Number of price levels to return
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMarketsTickerOrderbookResponse'
      x-evidence:
        kind: documentation
  /portfolio/balance:
    get:
      operationId: get_portfolio_balance
      tags:
      - Portfolio
      summary: 'Test it with your balance: GET /portfolio/balance returns the account balance in cents.'
      x-source: https://www.dwellir.com/guides/kalshi-api-guide.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPortfolioBalanceResponse'
      x-evidence:
        kind: documentation
  /portfolio/events/orders:
    post:
      operationId: post_portfolio_events_orders
      tags:
      - Portfolio
      summary: This example places a 1-contract yes bid at $0.01 on an open demo market, then cancels it.
      description: Create a new order (V2) in the portfolio.
      x-source: https://www.dwellir.com/guides/kalshi-api-guide.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostPortfolioEventsOrdersRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostPortfolioEventsOrdersResponse'
      x-evidence:
        kind: documentation
  /portfolio/events/orders/{orderId}/amend:
    post:
      operationId: post_portfolio_events_orders_orderId_amend
      tags:
      - Portfolio
      summary: Change an order
      description: Amend an existing order.
      x-source: https://www.dwellir.com/guides/kalshi-api-guide.md
      parameters:
      - name: orderId
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /series/{seriesTicker}:
    get:
      operationId: get_series_seriesTicker
      tags:
      - Series
      summary: GET /series/{series_ticker} returns information about a series.
      x-source: https://www.dwellir.com/guides/kalshi-api-guide.md
      parameters:
      - name: seriesTicker
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /series/{seriesTicker}/markets/{ticker}/candlesticks:
    get:
      operationId: get_series_seriesTicker_markets_ticker_candlesticks
      tags:
      - Series
      summary: GET /series/{series_ticker}/markets/{ticker}/candlesticks (1‑minute, 1‑hour and 1‑day bars). start_ts, end_ts and period_interval
        are required.
      x-source: https://www.dwellir.com/guides/kalshi-api-guide.md
      parameters:
      - name: seriesTicker
        in: path
        required: true
        schema:
          type: string
      - name: ticker
        in: path
        required: true
        schema:
          type: string
      - name: start_ts
        in: query
        required: true
        schema:
          type: integer
        description: Start timestamp (Unix ms)
      - name: end_ts
        in: query
        required: true
        schema:
          type: integer
        description: End timestamp (Unix ms)
      - name: period_interval
        in: query
        required: true
        schema:
          type: string
        description: Interval for candlesticks (e.g., 1m, 1h, 1d)
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /trade-api/ws/v2:
    get:
      operationId: get_trade_api_ws_v2
      tags:
      - Trade Api
      summary: WebSocket handshake for Kalshi API
      description: Establish a signed WebSocket connection.
      x-source: https://www.dwellir.com/guides/kalshi-api-guide.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /{apikey}/v1:
    get:
      operationId: get_apikey_v1
      tags:
      - Api
      summary: GET /{apiKey}/v1
      x-source: https://www.dwellir.com/docs/aptos
      parameters:
      - name: apikey
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl TypeScript SDK (@aptos-labs/ts-sdk) Python SDK (aptos-sdk) Rust SDK Bash Copy Text curl -X GET https://api-aptos-mainnet.n.dwellir.com/YOUR_API_KEY/v1\
          \  -H \" Accept: application/json \" \n Network Information Copy Anchor Link \n Parameter Value Details Chain ID 1 Mainnet Native Token\
          \ APT 1 APT = 100,000,000 Octas Consensus AptosBFT v4 ~250 ms blocks Execution Block-STM Parallel transactions \n RES"
components:
  schemas:
    GetAccountLimitsResponse:
      type: object
      properties:
        tier:
          type: string
          description: Account tier
        read_bucket_size:
          type: integer
          description: Read token bucket size
        write_bucket_size:
          type: integer
          description: Write token bucket size
    PostAuthApiKeyResponse:
      type: object
      properties:
        apiKey:
          type: string
        secret:
          type: string
        passphrase:
          type: string
    GetAuthDeriveApiKeyResponse:
      type: object
      properties:
        apiKey:
          type: string
        secret:
          type: string
        passphrase:
          type: string
    GetMarketsTickerOrderbookResponse:
      type: object
      properties:
        orderbook_fp:
          type: object
          description: Fixed‑point order book data
        yes_dollars:
          type: array
          description: List of [price, count] pairs for yes bids
        no_dollars:
          type: array
          description: List of [price, count] pairs for no bids
    GetPortfolioBalanceResponse:
      type: object
      properties:
        balance:
          type: integer
          description: Account balance in cents
    PostPortfolioEventsOrdersRequest:
      type: object
      properties:
        ticker:
          type: string
          description: Market ticker to trade
        side:
          type: string
          description: bid = long yes, ask = long no
        count:
          type: string
          description: Contracts, fixed-point string
        price:
          type: string
          description: Price in dollars, fixed-point string (e.g., "0.0100")
        time_in_force:
          type: string
          description: Order time in force (good_till_canceled, immediate_or_cancel, fill_or_kill)
        self_trade_prevention_type:
          type: string
          description: Self‑trade prevention type (taker_at_cross or maker)
        client_order_id:
          type: string
          description: Optional client‑generated UUID to allow safe retries
      required:
      - ticker
      - side
      - count
      - price
      - time_in_force
      - self_trade_prevention_type
    PostPortfolioEventsOrdersResponse:
      type: object
      properties:
        order_id:
          type: string
          description: Identifier of the created order
        fill_count:
          type: string
          description: Number of contracts filled immediately
        remaining_count:
          type: string
          description: Number of contracts still open
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-Api-Key
security:
- apiKey: []
tags:
- name: Account
- name: Api
- name: Api Keys
- name: Auth
- name: Dwellir Public
- name: Exchange
- name: Historical
- name: Markets
- name: Portfolio
- name: Series
- name: Trade Api