returns Position
Single enriched position by id.
| Name | Type | Description |
|---|---|---|
| positionId | String! | The position's id. |
Read projection for a single position.
Pairs cents-precision fields (costBasis, currentValue) with
pre-computed dollar floats (*_dollars) to spare clients the
conversion. The cents fields are authoritative.
| Field | Type | Description |
|---|---|---|
| id | String! | Position ID (pos_* ULID). |
| portfolioId | String! | Owning portfolio ID. |
| securityId | String! | Held security ID. |
| securityName | String | Cached display name of the held security, denormalized for list rendering. May lag the security row's current name briefly. |
| entityName | String | Cached display name of the security's issuing entity. |
| quantity | Float! | Quantity held in units defined by quantityType. |
| quantityType | String! | Unit basis (shares, units, principal). |
| costBasis | Int! | Cost basis in **cents** of currency. Authoritative. |
| costBasisDollars | Float! | Cost basis pre-converted to dollars (cost_basis / 100). Convenience for display; costBasis is the source of truth. |
| currency | String! | ISO 4217 currency code for costBasis and currentValue. |
| currentValue | Int | Latest mark-to-market value in **cents**, or null if unmarked. |
| currentValueDollars | Float | Current value in dollars (current_value / 100). null when currentValue is null. |
| valuationDate | Date | Date currentValue was sourced (YYYY-MM-DD). |
| valuationSource | String | Free-text source attribution for the current valuation. |
| acquisitionDate | Date | Date the position was acquired (YYYY-MM-DD). |
| dispositionDate | Date | Date the position was disposed, if status='disposed'. null for active positions. |
| status | String! | Lifecycle state. One of: active (currently held), disposed (soft-deleted via update-portfolio-block dispose), archived (historical record only). |
| notes | String | Free-text notes attached to the position. |
| createdAt | DateTime! | Row creation timestamp (UTC). |
| updatedAt | DateTime! | Last-modified timestamp (UTC). |
{ position(positionId: "...") { id portfolioId securityId securityName } }curl -X POST "https://api.robosystems.ai/extensions/$GRAPH_ID/graphql" \
-H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "{ position(positionId: \"...\") { id portfolioId securityId securityName } }"}'