Stocks | INFONITE | Documentation

[
  {
    "id": "6aa75284bfa8241c43cb6308",
    "product": "investment_asset",
    "sub_family": "investment_asset:stock",
    "fetch_date": "2026-09-12T01:48:52+00:00",
    "account": {
      "type": "iban",
      "control_digits": "17",
      "entity_code": "9999",
      "entity_country": "ES",
      "entity_office": "0000",
      "masked": "ES969999************9653",
      "value": "ES9699990000171900259653"
    },
    "customer_segment": "personal",
    "product_name": "STOCK EXAMPLE INC",
    "contract": {
      "value": "9988776655",
      "entity_code": "9999",
      "entity_office": "0000",
      "control_digits": "62",
      "type": "generic"
    },
    "product_alias": "Example Inc. Class A",
    "product_description": "Example Inc. Class A Fund",
    "isin": "ES9876543210",
    "ticker": "EXP",
    "market": "SMTS",
    "category": "Categoría del Stock",
    "unit_price": {
      "currency": "EUR",
      "amount": "NaN"
    },
    "quantity": "12.456600",
    "valuation": {
      "currency": "EUR",
      "amount": "2300.00"
    },
    "valuation_date": "2026-09-12",
    "appreciation": {
      "currency": "EUR",
      "amount": "100.41"
    },
    "performance": {
      "value": "0.043657",
      "unit": "%",
      "description": "Rendimiento"
    }
  }
]

Listed holdings — shares and other traded securities.

Each position carries the instrument, its identifiers, the quantity held, the price at the moment of the extraction, the valuation and the result, in the currency the institution reports. Field by field in Investments.

A valuation is a snapshot, not a quote. It is what the institution showed when the engine read it; it does not move afterwards and it is not a market feed.

Requires the stocks_read feature

Features are chosen when the execution starts, not here. An execution that did not ask for stocks_read answers 204, and the only way to get the data is to run another one.

Status	Meaning
`200`	The positions.
`202`	`feature_not_ready` — `stocks_read` is still running. Only this family waits: the ones that already closed answer now.
`204`	The execution never asked for `stocks_read`. No body.
`404`	No execution with that id for your application, or it has been deleted.

Server to server only. This call is authorised with your application secret: it belongs in your backend, never in a browser, a mobile app or anything your customer can read.

Listed holdings — shares and other traded securities. Each position carries the instrument, its identifiers, the quantity held, the price at the moment of the extraction, the valuation and the result, in the currency the institution reports. Field by field in [Investments](/guides/data-models/banking/investments). <Warning> **A valuation is a snapshot, not a quote.** It is what the institution showed when the engine read it; it does not move afterwards and it is not a market feed. </Warning> <Note title="Requires the `stocks_read` feature"> Features are chosen when the execution **starts**, not here. An execution that did not ask for `stocks_read` answers `204`, and the only way to get the data is to run another one. </Note> | Status | Meaning | | :--- | :--- | | `200` | The positions. | | `202` | `feature_not_ready` — `stocks_read` is still running. **Only this family waits**: the ones that already closed answer now. | | `204` | The execution never asked for `stocks_read`. No body. | | `404` | No execution with that id for your application, or it has been deleted. | <Note> **Server to server only.** This call is authorised with your application secret: it belongs in your backend, never in a browser, a mobile app or anything your customer can read. </Note>

Authentication

X-APP-SECRETstring

Application Secret

Path parameters

execution_idstringRequiredformat: "object-id"

The execution, as the acceptance response returned it.

Response

200 OK
Equity positions: what is held, how much of it, at what cost and what it is worth on the day the source reported it.

An empty list is an answer, not a gap: the feature ran and the source reported none.

idstringformat: "object-id"

Product ID for the current execution. Note: it may change between executions.

product"investment_asset"

sub_family"investment_asset:stock"

fetch_datestringformat: "datetime"

Date this product was fetched

accountobject

Account identifier

customer_segmentenum

product_namestring

Product name

contractobjectOptional

Contract if present

product_aliasstringOptional

Product alias

product_descriptionstringOptional

Product Description

isinstringOptional

ISIN code

tickerstringOptional

Ticker

marketstringOptional

Market

categorystringOptional

Errors

404

Not Found Error

422

Unprocessable Entity Error

Listed holdings — shares and other traded securities.

A valuation is a snapshot, not a quote. It is what the institution showed when the engine read it; it does not move afterwards and it is not a market feed.

Requires the stocks_read feature

Features are chosen when the execution starts, not here. An execution that did not ask for stocks_read answers 204, and the only way to get the data is to run another one.

Status	Meaning
`200`	The positions.
`202`	`feature_not_ready` — `stocks_read` is still running. Only this family waits: the ones that already closed answer now.
`204`	The execution never asked for `stocks_read`. No body.
`404`	No execution with that id for your application, or it has been deleted.

Server to server only. This call is authorised with your application secret: it belongs in your backend, never in a browser, a mobile app or anything your customer can read.