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

# Position Updates

> Account snapshot on position change (no `signature` or `eventName`). Throttled per DCA account.



## AsyncAPI

````yaml cn/datastream/dca.json dcaJupiterPosition
id: dcaJupiterPosition
title: Position Updates
description: >-
  Account snapshot on position change (no `signature` or `eventName`). Throttled
  per DCA account.
servers:
  - id: production
    protocol: wss
    host: datastream.solanatracker.io
    bindings: []
    variables:
      - id: apiKey
        description: Your unique API key from Data API subscription
        allowedValues: []
        examples: []
address: /
parameters: []
bindings: []
operations:
  - &ref_1
    id: subscribeToJupiterDcaPosition
    title: Subscribe to jupiter dca position
    description: Subscribe — position updates (`dca:jupiter:position`)
    type: receive
    messages:
      - &ref_5
        id: joindcaJupiterPosition
        payload:
          - name: joindcaJupiterPosition
            description: Subscribe — position updates (`dca:jupiter:position`)
            type: object
            properties:
              - name: type
                type: string
                description: join
                required: true
              - name: room
                type: string
                description: dca:jupiter:position
                required: true
        headers: []
        jsonPayloadSchema:
          type: object
          required:
            - type
            - room
          properties:
            type:
              type: string
              const: join
              default: join
              x-parser-schema-id: <anonymous-schema-203>
            room:
              type: string
              const: dca:jupiter:position
              default: dca:jupiter:position
              x-parser-schema-id: <anonymous-schema-204>
          examples:
            - type: join
              room: dca:jupiter:position
          x-parser-schema-id: <anonymous-schema-202>
        title: Joindca jupiter position
        description: Subscribe — position updates (`dca:jupiter:position`)
        example: |-
          {
            "type": "join",
            "room": "dca:jupiter:position"
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: joindcaJupiterPosition
          - id: x-parser-message-name
            value: joindcaJupiterPosition
    bindings: []
    extensions: &ref_0
      - id: x-codeSamples
        value: &ref_9
          - lang: typescript
            label: SDK
            source: |
              import { Datastream } from '@solana-tracker/data-api';

              const dataStream = new Datastream({
                wsUrl: 'wss://datastream.solanatracker.io/YOUR_API_KEY',
              });

              await dataStream.connect();

              const sub = dataStream.subscribe.dca.position().on((data) => {
                console.log(data);
              });

              // sub.unsubscribe();
      - id: x-parser-unique-object-id
        value: dcaJupiterPosition
  - &ref_3
    id: receiveJupiterDcaPositionConfirmation
    title: Receive jupiter dca position confirmation
    description: Subscription confirmed
    type: send
    messages:
      - &ref_7
        id: dcaJupiterPositionJoined
        payload:
          - name: dcaJupiterPositionJoined
            description: Subscription confirmed
            type: object
            properties:
              - name: type
                type: string
                description: joined
                required: false
              - name: room
                type: string
                required: false
        headers: []
        jsonPayloadSchema:
          type: object
          properties:
            type:
              type: string
              const: joined
              x-parser-schema-id: <anonymous-schema-206>
            room:
              type: string
              x-parser-schema-id: <anonymous-schema-207>
          examples:
            - type: joined
              room: dca:jupiter:position
          x-parser-schema-id: <anonymous-schema-205>
        title: Dca jupiter position joined
        description: Subscription confirmed
        example: |-
          {
            "type": "joined",
            "room": "dca:jupiter:position"
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: dcaJupiterPositionJoined
          - id: x-parser-message-name
            value: dcaJupiterPositionJoined
    bindings: []
    extensions: *ref_0
  - &ref_4
    id: receiveJupiterDcaPositionData
    title: Receive jupiter dca position data
    description: Receive — position snapshots
    type: send
    messages:
      - &ref_8
        id: dcaJupiterPositionMessage
        payload:
          - name: dcaJupiterPositionMessage
            description: Receive — position snapshots
            type: object
            properties:
              - name: type
                type: string
                description: message
                required: false
              - name: room
                type: string
                required: false
              - name: data
                type: object
                required: false
                properties:
                  - name: program
                    type: string
                    required: false
                  - name: programId
                    type: string
                    required: false
                  - name: pubkey
                    type: string
                    required: false
                  - name: address
                    type: string
                    required: false
                  - name: owner
                    type: string
                    required: false
                  - name: slot
                    type: integer
                    required: false
                  - name: timestamp
                    type: integer
                    required: false
                  - name: writeVersion
                    type: integer
                    required: false
                  - name: order
                    type: object
                    description: Full order object (same shape as Data API DCA order)
                    required: false
                    properties:
                      - name: program
                        type: string
                        required: false
                      - name: programId
                        type: string
                        required: false
                      - name: address
                        type: string
                        required: false
                      - name: owner
                        type: string
                        required: false
                      - name: status
                        type: string
                        required: false
                      - name: direction
                        type: string
                        required: false
                      - name: pair
                        type: string
                        required: false
                      - name: depositedUsd
                        type: number
                        required: false
                      - name: progressPercent
                        type: number
                        required: false
                      - name: input
                        type: object
                        required: false
                      - name: output
                        type: object
                        required: false
        headers: []
        jsonPayloadSchema:
          type: object
          properties:
            type:
              type: string
              const: message
              x-parser-schema-id: <anonymous-schema-209>
            room:
              type: string
              x-parser-schema-id: <anonymous-schema-210>
            data:
              type: object
              properties:
                program:
                  type: string
                  x-parser-schema-id: <anonymous-schema-119>
                programId:
                  type: string
                  x-parser-schema-id: <anonymous-schema-120>
                pubkey:
                  type: string
                  x-parser-schema-id: <anonymous-schema-121>
                address:
                  type: string
                  x-parser-schema-id: <anonymous-schema-122>
                owner:
                  type: string
                  x-parser-schema-id: <anonymous-schema-123>
                slot:
                  type: integer
                  x-parser-schema-id: <anonymous-schema-124>
                timestamp:
                  type: integer
                  x-parser-schema-id: <anonymous-schema-125>
                writeVersion:
                  type: integer
                  x-parser-schema-id: <anonymous-schema-126>
                order:
                  type: object
                  description: Full order object (same shape as Data API DCA order)
                  properties:
                    program:
                      type: string
                      x-parser-schema-id: <anonymous-schema-30>
                    programId:
                      type: string
                      x-parser-schema-id: <anonymous-schema-31>
                    address:
                      type: string
                      x-parser-schema-id: <anonymous-schema-32>
                    owner:
                      type: string
                      x-parser-schema-id: <anonymous-schema-33>
                    status:
                      type: string
                      x-parser-schema-id: <anonymous-schema-34>
                    direction:
                      type: string
                      x-parser-schema-id: <anonymous-schema-35>
                    pair:
                      type: string
                      x-parser-schema-id: <anonymous-schema-36>
                    depositedUsd:
                      type: number
                      nullable: true
                      x-parser-schema-id: <anonymous-schema-37>
                    progressPercent:
                      type: number
                      nullable: true
                      x-parser-schema-id: <anonymous-schema-38>
                    input:
                      type: object
                      x-parser-schema-id: <anonymous-schema-39>
                    output:
                      type: object
                      x-parser-schema-id: <anonymous-schema-40>
                  x-parser-schema-id: DcaOrderWs
              x-parser-schema-id: DcaPositionEvent
          examples:
            - type: message
              room: dca:jupiter:position
              data:
                program: jupiter
                programId: DCA265Vj8a9CEuX1eb1LWRnDT7uK6q1xMipnNyatn23M
                pubkey: 82jLLG1C8rbmr1ek4CKAg3TuQh977epmBLcJr8mB6NDo
                address: 82jLLG1C8rbmr1ek4CKAg3TuQh977epmBLcJr8mB6NDo
                owner: 2FbbdMWfrfGpyyK4Wh76vyxbmDGcp3LxZNhwBwFpV5UK
                slot: 312457400
                timestamp: 1710005000000
                writeVersion: 312457400
                order:
                  program: jupiter
                  programId: DCA265Vj8a9CEuX1eb1LWRnDT7uK6q1xMipnNyatn23M
                  address: 82jLLG1C8rbmr1ek4CKAg3TuQh977epmBLcJr8mB6NDo
                  owner: 2FbbdMWfrfGpyyK4Wh76vyxbmDGcp3LxZNhwBwFpV5UK
                  status: active
                  direction: mixed
                  pair: USDS → SOL
                  input:
                    mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                    symbol: USDS
                    decimals: 6
                    image: https://image.solanatracker.io/proxy?url=example
                    priceUsd: 1
                  output:
                    mint: So11111111111111111111111111111111111111112
                    symbol: SOL
                    decimals: 9
                    priceUsd: 142.5
                  deposited: 10000
                  depositedUsd: 10005.02
                  used: 1200
                  usedUsd: 1200.6
                  remaining: 8800
                  remainingUsd: 8804.42
                  received: 8.4
                  receivedUsd: 1197
                  perCycle: 100
                  perCycleUsd: 100.05
                  progressPercent: 12
                  volume: 10000
                  volumeUsd: 10005.02
                  createdAt: '2024-06-01T12:00:00.000Z'
                  nextCycleAt: '2024-06-02T12:00:00.000Z'
                  raw:
                    deposited: '10000000000'
                    used: '1200000000'
                    remaining: '8800000000'
                    received: '8400000000'
                    perCycle: '100000000'
                    createdAt: 1717243200
                    nextCycleAt: 1717329600
          x-parser-schema-id: <anonymous-schema-208>
        title: Dca jupiter position message
        description: Receive — position snapshots
        example: |-
          {
            "type": "message",
            "room": "dca:jupiter:position",
            "data": {
              "program": "jupiter",
              "programId": "DCA265Vj8a9CEuX1eb1LWRnDT7uK6q1xMipnNyatn23M",
              "pubkey": "82jLLG1C8rbmr1ek4CKAg3TuQh977epmBLcJr8mB6NDo",
              "address": "82jLLG1C8rbmr1ek4CKAg3TuQh977epmBLcJr8mB6NDo",
              "owner": "2FbbdMWfrfGpyyK4Wh76vyxbmDGcp3LxZNhwBwFpV5UK",
              "slot": 312457400,
              "timestamp": 1710005000000,
              "writeVersion": 312457400,
              "order": {
                "program": "jupiter",
                "programId": "DCA265Vj8a9CEuX1eb1LWRnDT7uK6q1xMipnNyatn23M",
                "address": "82jLLG1C8rbmr1ek4CKAg3TuQh977epmBLcJr8mB6NDo",
                "owner": "2FbbdMWfrfGpyyK4Wh76vyxbmDGcp3LxZNhwBwFpV5UK",
                "status": "active",
                "direction": "mixed",
                "pair": "USDS → SOL",
                "input": {
                  "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                  "symbol": "USDS",
                  "decimals": 6,
                  "image": "https://image.solanatracker.io/proxy?url=example",
                  "priceUsd": 1
                },
                "output": {
                  "mint": "So11111111111111111111111111111111111111112",
                  "symbol": "SOL",
                  "decimals": 9,
                  "priceUsd": 142.5
                },
                "deposited": 10000,
                "depositedUsd": 10005.02,
                "used": 1200,
                "usedUsd": 1200.6,
                "remaining": 8800,
                "remainingUsd": 8804.42,
                "received": 8.4,
                "receivedUsd": 1197,
                "perCycle": 100,
                "perCycleUsd": 100.05,
                "progressPercent": 12,
                "volume": 10000,
                "volumeUsd": 10005.02,
                "createdAt": "2024-06-01T12:00:00.000Z",
                "nextCycleAt": "2024-06-02T12:00:00.000Z",
                "raw": {
                  "deposited": "10000000000",
                  "used": "1200000000",
                  "remaining": "8800000000",
                  "received": "8400000000",
                  "perCycle": "100000000",
                  "createdAt": 1717243200,
                  "nextCycleAt": 1717329600
                }
              }
            }
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: dcaJupiterPositionMessage
          - id: x-parser-message-name
            value: dcaJupiterPositionMessage
    bindings: []
    extensions: *ref_0
  - &ref_2
    id: unsubscribeFromJupiterDcaPosition
    title: Unsubscribe from jupiter dca position
    description: Unsubscribe
    type: receive
    messages:
      - &ref_6
        id: leavedcaJupiterPosition
        payload:
          - name: leavedcaJupiterPosition
            description: Unsubscribe
            type: object
            properties:
              - name: type
                type: string
                description: leave
                required: true
              - name: room
                type: string
                description: dca:jupiter:position
                required: true
        headers: []
        jsonPayloadSchema:
          type: object
          required:
            - type
            - room
          properties:
            type:
              type: string
              const: leave
              default: leave
              x-parser-schema-id: <anonymous-schema-212>
            room:
              type: string
              const: dca:jupiter:position
              default: dca:jupiter:position
              x-parser-schema-id: <anonymous-schema-213>
          examples:
            - type: leave
              room: dca:jupiter:position
          x-parser-schema-id: <anonymous-schema-211>
        title: Leavedca jupiter position
        description: Unsubscribe
        example: |-
          {
            "type": "leave",
            "room": "dca:jupiter:position"
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: leavedcaJupiterPosition
          - id: x-parser-message-name
            value: leavedcaJupiterPosition
    bindings: []
    extensions: *ref_0
sendOperations:
  - *ref_1
  - *ref_2
receiveOperations:
  - *ref_3
  - *ref_4
sendMessages:
  - *ref_5
  - *ref_6
receiveMessages:
  - *ref_7
  - *ref_8
extensions:
  - id: x-codeSamples
    value: *ref_9
  - id: x-parser-unique-object-id
    value: dcaJupiterPosition
securitySchemes:
  - id: apiKeyAuth
    name: apiKey
    type: httpApiKey
    description: >-
      API key for authentication. Include your Datastream key in the connection
      URL: wss://datastream.solanatracker.io/{DATASTREAM_KEY}
    in: header
    extensions: []

````