resolvedmarkets-com Wallets API

openapi: 3.2.0
info:
  title: Resolved Markets Wallets API
  version: 1.2.0
  summary: High-fidelity orderbook data for Polymarket prediction markets and Hyperliquid perpetual futures, plus a backtesting engine and saved-strategy store.
  description: 'REST API for live and historical orderbook snapshots, trades, platform statistics, and event-driven strategy backtesting. Public endpoints (health, public-stats, payment packs) require no authentication. Data endpoints require an `X-API-Key` header where the key starts with `rm_` — get one at https://resolvedmarkets.com/api-keys. Account, subscription, and payment endpoints require a Clerk browser session and are not callable with an API key. WebSocket endpoints exist at `/ws/orderbook` and `/ws/chat` (see Servers / x-websocket).


    Probabilities are USDC prices in 0.01..0.99. Each Polymarket binary market has two tokens — UP (Yes outcome) and DOWN (No outcome) — each with its own orderbook. UP price + DOWN price ≈ 1.00.'
  termsOfService: https://resolvedmarkets.com/pricing
  contact:
    name: Resolved Markets
    email: info@resolvedmarkets.com
    url: https://resolvedmarkets.com
  license:
    name: Commercial — see Pricing page
    url: https://resolvedmarkets.com/pricing
servers:
- url: https://api.resolvedmarkets.com
  description: Production
security:
- ApiKeyAuth: []
tags:
- name: Wallets
paths:
  /v1/wallets/{address}/fills:
    get:
      summary: Wallet fills (address → fills)
      description: 'Every settled fill for a Polygon address, newest first.


        WHY THIS EXISTS: our trade tape records the CLOB matching-engine time in milliseconds, while every external record of the same fill carries the Polygon BLOCK time in whole seconds — a median ~2.3s later. Joining those two on TIME matches ~0.1% of pairs. Join on `transaction_hash` instead, which this endpoint returns on every row and which /v1/markets/{id}/trades has carried since 2026-08-26.


        `block_time` is the Polygon block time. `role`, `fee`, `counterparty`, `log_index` and `block_number` come from decoded on-chain OrderFilled logs and are **null until that transaction has been enriched** — null means ''not enriched yet'', NOT ''no fee''. `onchain_enriched` reports how much of the page carries them.


        TIER SCOPE: results are limited to the categories your tier allows. Free and Pro are crypto-only, so this returns only their crypto fills and `total` counts that same filtered set — it is a subset, not the wallet''s full history. `tier_scope` on the response states what was applied (`{filtered, allowed_categories, allowed_cryptos}`). A fill whose category is unknown is excluded under a restricted tier rather than allowed through. Naming a market your tier does not include in `market_id` returns 403 rather than an empty page. Scale and Enterprise are unfiltered.'
      parameters:
      - name: address
        in: path
        required: true
        schema:
          type: string
        description: 0x-prefixed 40-hex-character Polygon address (case-insensitive).
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 500
          maximum: 5000
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
      - name: order
        in: query
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          default: desc
        description: Order by block_time.
      - name: from
        in: query
        required: false
        schema:
          type: string
        description: Lower bound on block_time (UTC). Bounding the range prunes partitions.
      - name: to
        in: query
        required: false
        schema:
          type: string
        description: Upper bound on block_time (UTC).
      - name: market_id
        in: query
        required: false
        schema:
          type: string
        description: Restrict to one conditionId.
      responses:
        '200':
          description: Fills for the address
        '400':
          description: Malformed address
        '403':
          description: The market named in `market_id` is outside your tier (`tier_not_allowed`).
      tags:
      - Wallets
      operationId: getV1WalletsByAddressFills
      x-operation-id-source: derived
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key prefixed with `rm_`. Generate at https://resolvedmarkets.com/api-keys.
    ClerkSession:
      type: apiKey
      in: cookie
      name: __session
      description: Clerk browser session cookie. Used for account, payment, and admin endpoints. Not callable from API-key clients.
externalDocs:
  description: Interactive API docs and getting-started guides
  url: https://resolvedmarkets.com/docs
x-websocket:
  description: 'WebSocket endpoints. Authenticate via a `{ "type": "auth", "apiKey": "rm_..." }` message after connecting; the server replies `{ "type": "auth", "status": "ok" }` within 5 seconds or closes with code 4001.'
  endpoints:
  - path: /ws/orderbook
    description: 'Real-time orderbook stream. After auth, subscribe with `{ "type": "subscribe", "crypto": "BTC" }`.'
  - path: /ws/chat
    description: Operator chat. Admin connections require a one-time ticket from `POST /v1/admin/chat/ws-ticket`.