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

# Global Smart Money

> Markets ranked by smart-money edge across the selected wallet set.



## OpenAPI

````yaml /openapi.json post /api/v1/smart-money/global
openapi: 3.0.3
info:
  title: DataDash Analytics API
  version: 1.0.0
servers: []
security:
  - ApiKeyAuth: []
  - BearerAuth: []
paths:
  /api/v1/smart-money/global:
    post:
      tags:
        - Smart Money
      summary: Global Smart Money
      description: Markets ranked by smart-money edge across the selected wallet set.
      operationId: listSmartMoneyGlobal
      requestBody:
        content:
          application/json:
            schema:
              properties:
                filter:
                  $ref: '#/components/schemas/GlobalSmartMoneyFilter'
                orderBy:
                  description: >-
                    Sort keys in priority order; the first is the primary sort.
                    Defaults to the table's configured ranking when omitted.
                  items:
                    properties:
                      direction:
                        default: asc
                        enum:
                          - asc
                          - desc
                        type: string
                      field:
                        enum:
                          - marketId
                          - side
                          - isYes
                          - smartMoneyPrice
                          - marketPrice
                          - yesSlippage
                          - atRisk
                          - liquidity
                          - wallets
                          - daysLeft
                          - tagIds
                        type: string
                    required:
                      - field
                    type: object
                  type: array
                page:
                  $ref: '#/components/schemas/PageInput'
                searchKey:
                  description: >-
                    Free-text search over: Market (embedding + full-text
                    relevance).
                  type: string
              required:
                - page
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/GlobalSmartMoneyRow'
                type: array
          description: List of Global Smart Money rows
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: >-
            invalid request (malformed body, unknown field, or failed
            validation)
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: missing or invalid credentials
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: credentials lack access to this resource
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: internal error
components:
  schemas:
    GlobalSmartMoneyFilter:
      description: Filters to apply, combined with AND. Use a group for OR.
      items:
        $ref: '#/components/schemas/GlobalSmartMoneyFilterNode'
      minItems: 1
      type: array
    PageInput:
      properties:
        limit:
          minimum: 1
          type: integer
        offset:
          minimum: 0
          type: integer
      required:
        - limit
      type: object
    GlobalSmartMoneyRow:
      properties:
        atRisk:
          description: >-
            Total current USD value held in the market by the selected wallets,
            both sides, sum of unrealized_usd across the aggregated positions.
          format: double
          title: At Risk
          type: number
        daysLeft:
          description: >-
            Whole days from now until the market's end date, falling back to the
            event's end date when the market has none (coalesce(end_date,
            event_end_date)); negative if the end date has passed, null if
            neither is set
          format: int32
          title: Days Left
          type: integer
        isYes:
          description: >-
            Whether the favored Side is the Yes side, true when the cohort's
            implied Yes price is above the live Yes price (cohort price - yes
            price > 0). The boolean behind Side, for coloring/logic independent
            of the token name.
          title: Is Yes
          type: boolean
        liquidity:
          description: >-
            The market's on-book liquidity (market_metadata.liquidity, latest by
            updated_at)
          format: double
          title: Liquidity
          type: number
        marketId:
          description: Prediction market the positions belong to. One row per market.
          format: int32
          title: Market
          type: integer
        marketPrice:
          description: >-
            The live market price for the Side outcome, the badge's "vs market
            62¢" value. The live Yes price when Side is Yes, or 1 minus it when
            Side is No.
          format: double
          title: Market Price
          type: number
        side:
          description: >-
            The outcome smart money favors relative to the market, the market's
            own token name for the Yes side (outcomes[1]) when the cohort's
            implied Yes price is above the live Yes price (cohort price - yes
            price > 0), else the No-side token name (outcomes[2]). The badge's
            outcome label; direction of the Edge magnitude.
          title: Side
          type: string
        smartMoneyPrice:
          description: >-
            Smart money's price for the Side outcome, the badge's "Yes 70¢" /
            "No 78¢" value. Smart Money Probability when Side is Yes, or 1 minus
            it when Side is No.
          format: double
          title: Smart Money Price
          type: number
        tagIds:
          description: >-
            Tags/categories of the market's event. Filter to keep only markets
            in the selected categories (applied on the market's tags, constant
            per market).
          items:
            format: int32
            type: integer
          title: Category
          type: array
        wallets:
          description: >-
            Number of distinct wallets from the selected set holding a position
            in the market
          format: int64
          title: Wallets
          type: integer
        yesSlippage:
          description: >-
            Magnitude of the mispricing, the absolute gap between Smart Money
            Probability (the cohort's implied Yes price) and the live Yes price.
            Direction is carried by Side (Yes when the cohort price is above the
            market, No when below). Default sort is by this, descending (biggest
            mispricing first).
          format: double
          title: Edge
          type: number
      type: object
    Error:
      properties:
        code:
          description: machine-readable error code
          type: string
        message:
          description: human-readable description
          type: string
      required:
        - code
        - message
      type: object
    GlobalSmartMoneyFilterNode:
      description: A single condition, or a group combining conditions with AND/OR.
      oneOf:
        - $ref: '#/components/schemas/GlobalSmartMoneyCondition'
        - $ref: '#/components/schemas/GlobalSmartMoneyFilterGroup'
    GlobalSmartMoneyCondition:
      description: >-
        A single field condition. in/notIn take an array of values;
        matches/notMatches take one search term.
      oneOf:
        - $ref: '#/components/schemas/GlobalSmartMoneyNumericCondition'
        - $ref: '#/components/schemas/GlobalSmartMoneyIdCondition'
        - $ref: '#/components/schemas/GlobalSmartMoneyTextCondition'
        - $ref: '#/components/schemas/GlobalSmartMoneyAddressCondition'
        - $ref: '#/components/schemas/GlobalSmartMoneyBooleanCondition'
    GlobalSmartMoneyFilterGroup:
      description: >-
        A group of conditions and nested groups, combined with the group's
        operator.
      properties:
        filters:
          items:
            oneOf:
              - $ref: '#/components/schemas/GlobalSmartMoneyCondition'
              - $ref: '#/components/schemas/GlobalSmartMoneyFilterInnerGroup'
          minItems: 1
          type: array
        operator:
          enum:
            - AND
            - OR
          type: string
      required:
        - operator
        - filters
      type: object
    GlobalSmartMoneyNumericCondition:
      properties:
        field:
          enum:
            - smartMoneyPrice
            - marketPrice
            - yesSlippage
            - atRisk
            - liquidity
            - wallets
            - daysLeft
            - userRank
          type: string
        operator:
          enum:
            - eq
            - neq
            - lt
            - lte
            - gt
            - gte
          type: string
        value:
          oneOf:
            - format: double
              type: number
            - items:
                format: double
                type: number
              minItems: 1
              type: array
      required:
        - field
        - operator
        - value
      type: object
    GlobalSmartMoneyIdCondition:
      properties:
        field:
          enum:
            - marketId
            - tagIds
          type: string
        operator:
          enum:
            - in
            - notIn
          type: string
        value:
          oneOf:
            - format: int32
              type: integer
            - items:
                format: int32
                type: integer
              minItems: 1
              type: array
      required:
        - field
        - operator
        - value
      type: object
    GlobalSmartMoneyTextCondition:
      properties:
        field:
          enum:
            - side
          type: string
        operator:
          enum:
            - in
            - notIn
            - matches
            - notMatches
          type: string
        value:
          oneOf:
            - type: string
            - items:
                type: string
              minItems: 1
              type: array
      required:
        - field
        - operator
        - value
      type: object
    GlobalSmartMoneyAddressCondition:
      description: inCohort/notInCohort take cohort ids instead of addresses.
      properties:
        field:
          enum:
            - userId
          type: string
        operator:
          enum:
            - in
            - notIn
            - matches
            - notMatches
            - inCohort
            - notInCohort
          type: string
        value:
          oneOf:
            - type: string
            - items:
                type: string
              minItems: 1
              type: array
      required:
        - field
        - operator
        - value
      type: object
    GlobalSmartMoneyBooleanCondition:
      properties:
        field:
          enum:
            - isYes
            - inSignals
          type: string
        operator:
          enum:
            - eq
          type: string
        value:
          type: boolean
      required:
        - field
        - operator
        - value
      type: object
    GlobalSmartMoneyFilterInnerGroup:
      description: >-
        A nested group. Its members must be conditions, which bounds grouping at
        two levels.
      properties:
        filters:
          items:
            $ref: '#/components/schemas/GlobalSmartMoneyCondition'
          minItems: 1
          type: array
        operator:
          enum:
            - AND
            - OR
          type: string
      required:
        - operator
        - filters
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: API key issued for programmatic access.
      in: header
      name: X-Api-Key
      type: apiKey
    BearerAuth:
      bearerFormat: JWT
      description: User access token.
      scheme: bearer
      type: http

````