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

# Get Active Artists

> Paginated activity stats for artists on the In•Process protocol: moments created, airdrops, and moment counts by creation channel (`telegram`, `web`, `api`, `sms`).



## OpenAPI

````yaml GET /artists/active
openapi: 3.1.0
info:
  title: In•Process API
  description: >-
    The In•Process API enables browsing and managing moments from timelines.
    Retrieve moments from a specific artist's timeline, browse the in•process
    collective timeline, or filter by collection. The API supports creating
    moments, managing collections, handling payments, and interacting with the
    In•Process protocol ecosystem.
  version: 1.0.0
servers:
  - url: https://api.inprocess.world/api
    description: Production server
security: []
paths:
  /artists/active:
    get:
      summary: Get Active Artists
      description: >-
        Paginated activity stats for artists on the In•Process protocol: moments
        created, airdrops, and moment counts by creation channel (`telegram`,
        `web`, `api`, `sms`).
      operationId: getActiveArtists
      parameters:
        - name: period
          in: query
          required: false
          description: >-
            Restrict which moments are counted: approximately the last day,
            week, or month. `all` means no time limit.
          schema:
            type: string
            enum:
              - day
              - week
              - month
              - all
            default: all
        - name: limit
          in: query
          required: false
          description: Page size (1 to 100). Default 20.
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
        - name: page
          in: query
          required: false
          description: 1-based page number. Default 1.
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: artist
          in: query
          required: false
          description: >-
            Filter by wallet (`0x` + 40 hex, case-insensitive) or username
            substring.
          schema:
            type: string
            minLength: 1
        - name: sort_by
          in: query
          required: false
          description: Metric to sort by.
          schema:
            type: string
            enum:
              - created_count
              - airdropped_count
              - telegram_count
              - web_count
              - api_count
              - sms_count
            default: created_count
        - name: sort_order
          in: query
          required: false
          description: Sort direction.
          schema:
            type: string
            enum:
              - asc
              - desc
            default: desc
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetActiveArtistsResponse'
              example:
                artists:
                  - artist_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                    username: matt
                    wallets:
                      - address: '0x51027631B9DEF86e088C33368eC4E3A4BE0aD264'
                        type: farcaster
                    created_count: 12
                    airdropped_count: 3
                    telegram_count: 1
                    web_count: 8
                    api_count: 2
                    sms_count: 1
                total_count: 100
                page: 1
                total_pages: 5
        '400':
          description: Invalid query parameters
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - errors
                properties:
                  message:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      required:
                        - field
                        - message
                      properties:
                        field:
                          type: string
                        message:
                          type: string
              example:
                message: Invalid input
                errors:
                  - field: limit
                    message: Number must be less than or equal to 100
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                properties:
                  message:
                    type: string
      security: []
components:
  schemas:
    GetActiveArtistsResponse:
      type: object
      required:
        - artists
        - total_count
        - page
        - total_pages
      properties:
        artists:
          type: array
          items:
            $ref: '#/components/schemas/ActiveArtistStatsItem'
        total_count:
          type: integer
          minimum: 0
          description: Total artists matching the request (for pagination).
        page:
          type: integer
          minimum: 1
          description: Current page number.
        total_pages:
          type: integer
          minimum: 0
          description: Total pages at the current `limit`.
    ActiveArtistStatsItem:
      type: object
      description: Per-artist activity in the selected period.
      required:
        - artist_id
        - username
        - wallets
        - created_count
        - airdropped_count
        - telegram_count
        - web_count
        - api_count
        - sms_count
      properties:
        artist_id:
          type: string
          format: uuid
          description: Artist identifier.
        username:
          type: string
          description: Artist username.
        wallets:
          type: array
          description: Wallet addresses associated with this artist.
          items:
            type: object
            required:
              - address
              - type
            properties:
              address:
                type: string
              type:
                type: string
        created_count:
          type: integer
          minimum: 0
          description: Moments created in the period (In•Process protocol, Base mainnet).
        airdropped_count:
          type: integer
          minimum: 0
          description: >-
            Transfers counted as airdrops (no payment; recipient is not the
            artist) across that artist's moments in the period.
        telegram_count:
          type: integer
          minimum: 0
          description: Moments created via the `telegram` channel in the period.
        web_count:
          type: integer
          minimum: 0
          description: Moments created via `web` or a null channel in the period.
        api_count:
          type: integer
          minimum: 0
          description: Moments created via the `api` channel in the period.
        sms_count:
          type: integer
          minimum: 0
          description: Moments created via the `sms` channel in the period.

````