> ## 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.

# Signal

> Per-wallet, per-position insider signal scores for currently-held legs in active markets.



## OpenAPI

````yaml /openapi.json post /api/v1/signals/scores
openapi: 3.0.3
info:
  title: DataDash Analytics API
  version: 1.0.0
servers:
  - url: https://api.datadash.xyz
security:
  - ApiKeyAuth: []
  - BearerAuth: []
paths:
  /api/v1/signals/scores:
    post:
      tags:
        - Signals
      summary: Signal
      description: >-
        Per-wallet, per-position insider signal scores for currently-held legs
        in active markets.
      operationId: listSignalsScores
      requestBody:
        content:
          application/json:
            example:
              orderBy:
                - direction: desc
                  field: score
              page:
                limit: 50
                offset: 0
            schema:
              properties:
                filter:
                  $ref: '#/components/schemas/SignalScoreFilter'
                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:
                          - userId
                          - positionId
                          - marketId
                          - eventId
                          - tagIds
                          - avgEntryPrice
                          - totalBoughtShares
                          - tradeSize
                          - relSize
                          - daysToResolution
                          - pNow
                          - slipAbs
                          - score
                        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/SignalScoreRow'
                type: array
          description: List of Signal rows
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: >-
            invalid request (malformed body, unknown field, or failed
            validation)
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: internal error
      security: []
components:
  schemas:
    SignalScoreFilter:
      description: Filters to apply, combined with AND. Use a group for OR.
      items:
        $ref: '#/components/schemas/SignalScoreFilterNode'
      minItems: 1
      type: array
    PageInput:
      properties:
        limit:
          minimum: 1
          type: integer
        offset:
          minimum: 0
          type: integer
      required:
        - limit
      type: object
    SignalScoreRow:
      properties:
        avgEntryPrice:
          description: Average entry price of the shares still held (p_in)
          format: double
          title: Avg Entry Price
          type: number
        daysToResolution:
          description: Days from now to market end (<0 = overdue)
          format: int32
          title: Days Left
          type: integer
        event:
          $ref: '#/components/schemas/EventLookup'
        market:
          $ref: '#/components/schemas/MarketLookup'
        pNow:
          description: Live token price for this position (p_now)
          format: double
          title: Current Price
          type: number
        relSize:
          description: This bet vs the wallet's usual size (>1 = bigger than usual)
          format: double
          title: Relative Size
          type: number
        score:
          description: Final 0-100 insider score for this position
          format: double
          title: Insider Score
          type: number
        slipAbs:
          description: Signed price move since entry (p_now - p_in)
          format: double
          title: Slippage (abs)
          type: number
        tags:
          items:
            $ref: '#/components/schemas/TagLookup'
          type: array
        token:
          $ref: '#/components/schemas/TokenLookup'
        totalBoughtShares:
          description: All-time shares bought for this position
          format: double
          title: Total Bought Shares
          type: number
        tradeSize:
          description: This position's peak USD conviction (max_unrealized_buy_cost)
          format: double
          title: Trade Size
          type: number
        user:
          $ref: '#/components/schemas/UserLookup'
      type: object
    Error:
      properties:
        code:
          description: machine-readable error code
          type: string
        message:
          description: human-readable description
          type: string
      required:
        - code
        - message
      type: object
    SignalScoreFilterNode:
      description: A single condition, or a group combining conditions with AND/OR.
      oneOf:
        - $ref: '#/components/schemas/SignalScoreCondition'
        - $ref: '#/components/schemas/SignalScoreFilterGroup'
      title: Filter
    EventLookup:
      description: Resolved Event row.
      properties:
        active:
          description: Whether the event is currently active
          title: Active
          type: boolean
        archived:
          description: Whether the event is archived
          title: Archived
          type: boolean
        closed:
          description: Whether the event has been resolved
          title: Closed
          type: boolean
        daysLeft:
          description: >-
            Whole days until the event's end date; negative if it has passed,
            null if the event has no end date
          format: int32
          title: Days Left
          type: integer
        description:
          description: Detailed event description
          title: Description
          type: string
        endDate:
          description: Event end date
          format: date-time
          title: End Date
          type: string
        hoursSinceCreated:
          description: Whole hours since the event was created
          format: int32
          title: Hours Since Created
          type: integer
        icon:
          description: Event icon URL
          title: Icon
          type: string
        id:
          description: Event identifier
          format: int32
          title: Event ID
          type: integer
        image:
          description: Event banner image URL
          title: Image
          type: string
        liquidity:
          description: Total liquidity across all markets in this event
          format: double
          title: Liquidity
          type: number
        openInterest:
          description: Total open interest across all markets
          format: double
          title: Open Interest
          type: number
        seriesId:
          description: Series this event belongs to
          format: int32
          title: Series ID
          type: integer
        slug:
          description: URL-friendly event slug
          title: Slug
          type: string
        startDate:
          description: Event start date
          format: date-time
          title: Start Date
          type: string
        tagIds:
          description: Tags associated with this event
          items:
            format: int32
            type: integer
          title: Category
          type: array
        title:
          description: Event title
          title: Title
          type: string
        topMarketGroupItemTitle:
          description: Outcome name of the top market
          title: Top Market Group Item Title
          type: string
        topMarketOneDayPriceChange:
          description: >-
            24-hour price change of the top market (max YES token price) in this
            event
          format: double
          title: Top Market Price Change 24h
          type: number
        topMarketOneHourPriceChange:
          description: >-
            1-hour price change of the top market (max YES token price) in this
            event
          format: double
          title: Top Market Price Change 1h
          type: number
        topMarketOneMonthPriceChange:
          description: >-
            1-month price change of the top market (max YES token price) in this
            event
          format: double
          title: Top Market Price Change 1mo
          type: number
        topMarketOneWeekPriceChange:
          description: >-
            1-week price change of the top market (max YES token price) in this
            event
          format: double
          title: Top Market Price Change 1w
          type: number
        topMarketOneYearPriceChange:
          description: >-
            1-year price change of the top market (max YES token price) in this
            event
          format: double
          title: Top Market Price Change 1y
          type: number
        topMarketPrice:
          description: Price of the YES token of the top market (last trade price)
          format: double
          title: Top Market Price
          type: number
        topTokenName:
          description: Outcome name of the top token
          title: Top Token Name
          type: string
        traders:
          description: Number of unique traders in this event
          format: int32
          title: Traders
          type: integer
        trades:
          description: Number of trades in this event
          format: int32
          title: Trades
          type: integer
        volume:
          description: Total trading volume for this event
          format: double
          title: Volume
          type: number
        volume1mo:
          description: Trading volume in the last month
          format: double
          title: Volume 1mo
          type: number
        volume1wk:
          description: Trading volume in the last week
          format: double
          title: Volume 1w
          type: number
        volume1yr:
          description: Trading volume in the last year
          format: double
          title: Volume 1y
          type: number
        volume24h:
          description: Trading volume in the last 24 hours
          format: double
          title: Volume 24h
          type: number
      title: Event
      type: object
    MarketLookup:
      description: Resolved Market row.
      properties:
        active:
          description: Whether the market is currently active
          title: Active
          type: boolean
        archived:
          description: Whether the market is archived
          title: Archived
          type: boolean
        closed:
          description: Whether the market has been resolved
          title: Closed
          type: boolean
        daysLeft:
          description: Days left until market ends
          format: int32
          title: Days Left
          type: integer
        description:
          description: Detailed market description
          title: Description
          type: string
        endDate:
          description: Market end date
          format: date-time
          title: End Date
          type: string
        eventId:
          description: Parent event ID
          format: int32
          title: Event
          type: integer
        eventSlug:
          description: Parent event slug
          title: Event Slug
          type: string
        groupItemTitle:
          description: Title within a multi-market event group
          title: Group Item Title
          type: string
        hoursSinceCreated:
          description: Whole hours since the market was created
          format: int32
          title: Hours Since Created
          type: integer
        icon:
          description: Market icon URL
          title: Icon
          type: string
        id:
          description: Market identifier
          format: int32
          title: Id
          type: integer
        image:
          description: Market banner image URL
          title: Image
          type: string
        liquidity:
          description: Available liquidity
          format: double
          title: Liquidity
          type: number
        openInterest:
          description: Current open interest
          format: double
          title: Open Interest
          type: number
        outcomeNames:
          description: Outcome names for this market
          items:
            type: string
          title: Outcome Names
          type: array
        outcomePrices:
          description: Outcome prices for this market
          items:
            format: double
            type: number
          title: Outcome Prices
          type: array
        question:
          description: Market question
          title: Question
          type: string
        slug:
          description: URL-friendly market slug
          title: Slug
          type: string
        startDate:
          description: Market start date
          format: date-time
          title: Start Date
          type: string
        volume:
          description: Total trading volume
          format: double
          title: Volume
          type: number
        volume24h:
          description: Trading volume in the last 24 hours
          format: double
          title: Volume 24h
          type: number
      title: Market
      type: object
    TagLookup:
      description: Resolved Tag row.
      properties:
        allTimeVolume:
          description: All-time trading volume for this tag
          format: double
          title: All Time Volume
          type: number
        id:
          description: Tag identifier
          format: int32
          title: Id
          type: integer
        label:
          description: Tag display label
          title: Label
          type: string
        numEvents:
          description: Count of currently active events for this tag
          format: int32
          title: Active Event Counts
          type: integer
        numTraders:
          description: All-time trader counts for this tag
          format: int32
          title: Trader Counts
          type: integer
        slug:
          description: URL-friendly tag slug
          title: Slug
          type: string
      title: Tag
      type: object
    TokenLookup:
      description: Resolved Token row.
      properties:
        eventId:
          description: Parent event ID
          format: int32
          title: Event
          type: integer
        eventSlug:
          description: Slug of the parent event
          title: Event Slug
          type: string
        isYesToken:
          description: true if this is the YES token for the market
          title: Is Yes Token
          type: boolean
        marketClosed:
          description: Indicates whether the market is closed
          title: Market Closed
          type: boolean
        marketClosedTime:
          description: Date when the market was closed
          format: date-time
          title: Market Closed Time
          type: string
        marketEndDate:
          description: End date of the parent market
          format: date-time
          title: Market End Date
          type: string
        marketGroupItemTitle:
          description: Title within a multi-market event group
          title: Market Group Item Title
          type: string
        marketIcon:
          description: Icon URL of the parent market
          title: Market Icon
          type: string
        marketId:
          description: Parent market ID
          format: int32
          title: Market
          type: integer
        marketLiquidity:
          description: Available liquidity of the parent market
          format: double
          title: Market Liquidity
          type: number
        marketOneDayPriceChange:
          description: 24-hour price change of the parent market
          format: double
          title: Market Price Change 24h
          type: number
        marketOpenInterest:
          description: Current open interest of the parent market
          format: double
          title: Market Open Interest
          type: number
        marketQuestion:
          description: The question of the parent market
          title: Market Question
          type: string
        marketSlug:
          description: The slug of the parent market
          title: Market Slug
          type: string
        marketStartDate:
          description: Date when the market was started
          format: date-time
          title: Market Start Date
          type: string
        marketTraders:
          description: Number of unique traders in the parent market
          format: int32
          title: Market Traders
          type: integer
        marketTrades:
          description: Number of trades in the parent market
          format: int32
          title: Market Trades
          type: integer
        marketVolume:
          description: Total trading volume of the parent market
          format: double
          title: Market Volume
          type: number
        marketVolume24h:
          description: 24-hour trading volume of the parent market
          format: double
          title: Market Volume 24h
          type: number
        positionId:
          description: Position Identifier
          format: int32
          title: Position ID
          type: integer
        tagIds:
          description: Tags associated with this position's event
          items:
            format: int32
            type: integer
          title: Category
          type: array
        tokenId:
          description: Identifier for the token
          format: big-integer
          title: Token ID
          type: string
        tokenName:
          description: Token display name (Yes/No)
          title: Token Name
          type: string
        tokenPrice:
          description: Current token price
          format: double
          title: Token Price
          type: number
      title: Token
      type: object
    UserLookup:
      description: Resolved User row.
      properties:
        bio:
          description: User biography
          title: Bio
          type: string
        createdAt:
          description: Timestamp when the user was created.
          format: date-time
          title: Created At
          type: string
        displayName:
          description: User display name
          title: Display Name
          type: string
        pnl:
          description: User's profit and loss.
          format: double
          title: Pnl
          type: number
        profileImageUrl:
          description: User profile image URL
          title: Profile Image
          type: string
        pseudonym:
          description: User pseudonym
          title: Pseudonym
          type: string
        rank:
          description: User's profit and loss.
          format: int32
          title: Rank
          type: integer
        userId:
          description: User wallet address
          title: User ID
          type: string
        verifiedBadge:
          description: Whether the user has a verified badge
          title: Verified
          type: boolean
        xUsername:
          description: User's X (Twitter) username
          title: X Username
          type: string
      title: User
      type: object
    SignalScoreCondition:
      description: >-
        A single field condition. in/notIn take an array of values;
        matches/notMatches take one search term.
      oneOf:
        - $ref: '#/components/schemas/SignalScoreNumericCondition'
        - $ref: '#/components/schemas/SignalScoreIdCondition'
        - $ref: '#/components/schemas/SignalScoreAddressCondition'
        - $ref: '#/components/schemas/SignalScoreUserIdLookupCondition'
      title: Condition
    SignalScoreFilterGroup:
      description: >-
        A group of conditions and nested groups, combined with the group's
        operator.
      properties:
        filters:
          items:
            oneOf:
              - $ref: '#/components/schemas/SignalScoreCondition'
              - $ref: '#/components/schemas/SignalScoreFilterInnerGroup'
          minItems: 1
          type: array
        operator:
          enum:
            - AND
            - OR
          type: string
      required:
        - operator
        - filters
      title: Group
      type: object
    SignalScoreNumericCondition:
      properties:
        field:
          enum:
            - avgEntryPrice
            - totalBoughtShares
            - tradeSize
            - relSize
            - daysToResolution
            - pNow
            - slipAbs
            - score
            - userRank
            - updatedAt
          type: string
        operator:
          enum:
            - eq
            - neq
            - lt
            - lte
            - gt
            - gte
          type: string
        value:
          oneOf:
            - format: double
              title: Single value
              type: number
            - items:
                format: double
                type: number
              minItems: 1
              title: List of values
              type: array
      required:
        - field
        - operator
        - value
      title: Numeric
      type: object
    SignalScoreIdCondition:
      properties:
        field:
          enum:
            - positionId
            - marketId
            - eventId
            - tagIds
          type: string
        operator:
          enum:
            - in
            - notIn
          type: string
        value:
          oneOf:
            - format: int32
              title: Single value
              type: integer
            - items:
                format: int32
                type: integer
              minItems: 1
              title: List of values
              type: array
      required:
        - field
        - operator
        - value
      title: ID
      type: object
    SignalScoreAddressCondition:
      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:
            - title: Single value
              type: string
            - items:
                type: string
              minItems: 1
              title: List of values
              type: array
      required:
        - field
        - operator
        - value
      title: Wallet address
      type: object
    SignalScoreUserIdLookupCondition:
      description: >-
        Match this field against the keys a filter over one of its lookup tables
        yields. The operator names which lookup table to filter through.
      oneOf:
        - properties:
            field:
              enum:
                - userId
              type: string
            operator:
              enum:
                - userProfileLookup
              type: string
            value:
              description: Conditions to run against User Profile Lookup.
              properties:
                duration:
                  description: Time window for aggregation
                  properties:
                    operator:
                      enum:
                        - in
                        - notIn
                        - matches
                        - notMatches
                      type: string
                    value:
                      oneOf:
                        - enum:
                            - 1D
                            - 1W
                            - 1M
                            - 1Y
                            - ALL
                          title: Single value
                          type: string
                        - items:
                            enum:
                              - 1D
                              - 1W
                              - 1M
                              - 1Y
                              - ALL
                            type: string
                          minItems: 1
                          title: List of values
                          type: array
                  required:
                    - operator
                    - value
                  type: object
                filter:
                  $ref: '#/components/schemas/UserProfileLookupInnerFilter'
              required:
                - duration
              type: object
          required:
            - field
            - operator
            - value
          title: User Profile Lookup
          type: object
        - properties:
            field:
              enum:
                - userId
              type: string
            operator:
              enum:
                - userTagProfileLookup
              type: string
            value:
              description: Conditions to run against User Tag Profile Lookup.
              properties:
                duration:
                  description: Time window for aggregation
                  properties:
                    operator:
                      enum:
                        - in
                        - notIn
                        - matches
                        - notMatches
                      type: string
                    value:
                      oneOf:
                        - enum:
                            - 1D
                            - 1W
                            - 1M
                            - 1Y
                            - ALL
                          title: Single value
                          type: string
                        - items:
                            enum:
                              - 1D
                              - 1W
                              - 1M
                              - 1Y
                              - ALL
                            type: string
                          minItems: 1
                          title: List of values
                          type: array
                  required:
                    - operator
                    - value
                  type: object
                filter:
                  $ref: '#/components/schemas/UserTagProfileLookupInnerFilter'
                tagId:
                  description: Tag identifier
                  properties:
                    operator:
                      enum:
                        - in
                        - notIn
                      type: string
                    value:
                      oneOf:
                        - format: int32
                          title: Single value
                          type: integer
                        - items:
                            format: int32
                            type: integer
                          minItems: 1
                          title: List of values
                          type: array
                  required:
                    - operator
                    - value
                  type: object
              required:
                - tagId
                - duration
              type: object
          required:
            - field
            - operator
            - value
          title: User Tag Profile Lookup
          type: object
      title: Wallet lookup filter
    SignalScoreFilterInnerGroup:
      description: >-
        A nested group. Its members must be conditions, which bounds grouping at
        two levels.
      properties:
        filters:
          items:
            $ref: '#/components/schemas/SignalScoreCondition'
          minItems: 1
          type: array
        operator:
          enum:
            - AND
            - OR
          type: string
      required:
        - operator
        - filters
      title: Nested group
      type: object
    UserProfileLookupInnerFilter:
      description: Filters to apply, combined with AND. Use a group for OR.
      items:
        $ref: '#/components/schemas/UserProfileLookupInnerFilterNode'
      minItems: 1
      type: array
    UserTagProfileLookupInnerFilter:
      description: Filters to apply, combined with AND. Use a group for OR.
      items:
        $ref: '#/components/schemas/UserTagProfileLookupInnerFilterNode'
      minItems: 1
      type: array
    UserProfileLookupInnerFilterNode:
      description: A single condition, or a group combining conditions with AND/OR.
      oneOf:
        - $ref: '#/components/schemas/UserProfileLookupInnerCondition'
        - $ref: '#/components/schemas/UserProfileLookupInnerFilterGroup'
      title: Filter
    UserTagProfileLookupInnerFilterNode:
      description: A single condition, or a group combining conditions with AND/OR.
      oneOf:
        - $ref: '#/components/schemas/UserTagProfileLookupInnerCondition'
        - $ref: '#/components/schemas/UserTagProfileLookupInnerFilterGroup'
      title: Filter
    UserProfileLookupInnerCondition:
      description: >-
        A single field condition. in/notIn take an array of values;
        matches/notMatches take one search term.
      oneOf:
        - $ref: '#/components/schemas/UserProfileLookupInnerNumericCondition'
        - $ref: '#/components/schemas/UserProfileLookupInnerAddressCondition'
      title: Condition
    UserProfileLookupInnerFilterGroup:
      description: A group of conditions, combined with the group's operator.
      properties:
        filters:
          items:
            $ref: '#/components/schemas/UserProfileLookupInnerCondition'
          minItems: 1
          type: array
        operator:
          enum:
            - AND
            - OR
          type: string
      required:
        - operator
        - filters
      title: Group
      type: object
    UserTagProfileLookupInnerCondition:
      description: >-
        A single field condition. in/notIn take an array of values;
        matches/notMatches take one search term.
      oneOf:
        - $ref: '#/components/schemas/UserTagProfileLookupInnerNumericCondition'
        - $ref: '#/components/schemas/UserTagProfileLookupInnerAddressCondition'
      title: Condition
    UserTagProfileLookupInnerFilterGroup:
      description: A group of conditions, combined with the group's operator.
      properties:
        filters:
          items:
            $ref: '#/components/schemas/UserTagProfileLookupInnerCondition'
          minItems: 1
          type: array
        operator:
          enum:
            - AND
            - OR
          type: string
      required:
        - operator
        - filters
      title: Group
      type: object
    UserProfileLookupInnerNumericCondition:
      properties:
        field:
          enum:
            - rank
            - roi
            - realizedPnl
            - rankPercent
          type: string
        operator:
          enum:
            - eq
            - neq
            - lt
            - lte
            - gt
            - gte
          type: string
        value:
          oneOf:
            - format: double
              title: Single value
              type: number
            - items:
                format: double
                type: number
              minItems: 1
              title: List of values
              type: array
      required:
        - field
        - operator
        - value
      title: Numeric
      type: object
    UserProfileLookupInnerAddressCondition:
      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:
            - title: Single value
              type: string
            - items:
                type: string
              minItems: 1
              title: List of values
              type: array
      required:
        - field
        - operator
        - value
      title: Wallet address
      type: object
    UserTagProfileLookupInnerNumericCondition:
      properties:
        field:
          enum:
            - rank
            - roi
            - realizedPnl
            - rankPercent
          type: string
        operator:
          enum:
            - eq
            - neq
            - lt
            - lte
            - gt
            - gte
          type: string
        value:
          oneOf:
            - format: double
              title: Single value
              type: number
            - items:
                format: double
                type: number
              minItems: 1
              title: List of values
              type: array
      required:
        - field
        - operator
        - value
      title: Numeric
      type: object
    UserTagProfileLookupInnerAddressCondition:
      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:
            - title: Single value
              type: string
            - items:
                type: string
              minItems: 1
              title: List of values
              type: array
      required:
        - field
        - operator
        - value
      title: Wallet address
      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

````

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