> For the complete documentation index, see [llms.txt](https://fto-2.gitbook.io/fto-indicators-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fto-2.gitbook.io/fto-indicators-docs/api-reference/objects/properties-text-and-anchors/get-object-property.md).

# GetObjectProperty

Reads a simple or indexed property from a named chart object.

## Signature

```typescript
GetObjectProperty(...args: GetObjectPropertyArgs): number | string | null
```

## Parameters

| Name      | Type                    | Required | Description                                              |
| --------- | ----------------------- | -------- | -------------------------------------------------------- |
| `...args` | `GetObjectPropertyArgs` | Yes      | Arguments matching one of the expanded call forms below. |

## Returns

A string or number property value, or `null` when no chart is attached.

## Usage

* Without `propModifier`, tries the string property first, then returns the numeric property. An empty string is treated as absent and falls through to numeric conversion, so an empty `TEXT` value or an unsupported property can be returned as `0`. Use [GetObjectText](/fto-indicators-docs/api-reference/objects/properties-text-and-anchors/get-object-text.md) or [GetObjectStringProperty](/fto-indicators-docs/api-reference/objects/properties-text-and-anchors/get-object-string-property.md) when an empty string must be preserved.
* Without `propModifier`, `TIME1`, `TIME2`, and `TIME3` are Unix seconds.
* With a zero-based modifier, only `ObjectProperty.TIME`, `PRICE`, and `LEVEL_VALUE` are supported: time is Unix milliseconds, point price is numeric, and level value addresses a Fibonacci level.
* Do **not** pass a `TIME` value from this call straight into [MoveObjectPoint](/fto-indicators-docs/api-reference/objects/properties-text-and-anchors/move-object-point.md) — that API expects internal chart date-time or `FTODate`, not Unix milliseconds. Prefer `FTODate` / [SetObjectProperty](/fto-indicators-docs/api-reference/objects/properties-text-and-anchors/set-object-property.md) with indexed `TIME` when updating anchors.
* Raises an object error for missing objects, unsupported modified properties, or invalid point/level indexes.

Expanded call forms:

* `GetObjectProperty(chartId: number, name: string, propId: ObjectProperty, isStatic?: boolean): string | number | null`
* `GetObjectProperty(chartId: number, name: string, propId: ObjectProperty, propModifier: number, isStatic?: boolean): string | number | null`

## Example

```typescript
const trendName = 'MyIndicator_Trend'
const firstPrice = this.api.GetObjectProperty(
    0,
    trendName,
    ObjectProperty.PRICE,
    0,
    true
)
```

## Related API

* [SetObjectProperty](/fto-indicators-docs/api-reference/objects/properties-text-and-anchors/set-object-property.md)
* [GetObjectNumberProperty](/fto-indicators-docs/api-reference/objects/properties-text-and-anchors/get-object-number-property.md)
* [GetObjectStringProperty](/fto-indicators-docs/api-reference/objects/properties-text-and-anchors/get-object-string-property.md)
* [Chart-object cleanup](/fto-indicators-docs/api-reference/objects/creation-and-cleanup/chart-object-cleanup.md)