# Quote

`GET` `/v1/quotes/{ticker}`

Retrieve the latest stored market snapshot for one US equity or ETF ticker. The response includes last price, percent and dollar change, volume, day high and low, open, previous close, market capitalization and shares outstanding where available. Quotes refresh about every second for live-data tickers; use this for dashboards, alerts and any screen that needs a single live price.

## Use cases

- Live price tiles and watchlist rows
- Valuation inputs (price × shares for market cap checks)
- Day-range and volume context on security detail pages
- Alerting on price or percent change

## Input parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `ticker` | string | Yes | Ticker. |

## Output parameters

| Name | Type | Description |
| --- | --- | --- |
| `ticker` | string | Ticker. |
| `price` | float | Last trade or official close price. |
| `change` | float | Dollar change vs previous close. |
| `change_percentage` | float | Percent change vs previous close. |
| `volume` | integer | Session volume (shares). |
| `day_low` | float | Session low price. |
| `day_high` | float | Session high price. |
| `open` | float | Session open price. |
| `previous_close` | float | Previous session close. |
| `market_cap` | float | Market capitalization in USD when available. |
| `shares` | integer | Shares outstanding when available. |
| `updated_at` | string | Quote timestamp (ISO 8601). |

## Example response

```json
{
  "ticker": "AAPL",
  "price": 296.13,
  "change": -19.07,
  "change_percentage": -6.05,
  "volume": 102120.14,
  "day_low": null,
  "day_high": null,
  "open": null,
  "previous_close": 315.2,
  "market_cap": 4356284921340,
  "shares": 14687356000,
  "updated_at": "2026-06-16T09:53:14.094641+00:00"
}
```

## Examples

### cURL

```bash
curl "https://api.vantafin.com/v1/quotes/AAPL?apiKey=$VANTAFIN_API_KEY"
```

### Python

```python
from vantafin import RESTClient

client = RESTClient("vf-live-your_api_key")

result = client.get_quote("AAPL")

print(result)
```

### JavaScript

```javascript
import { RestClient } from "vantafin";

const client = new RestClient("vf-live-your_api_key");

const result = await client.getQuote("AAPL");

console.log(result);
```

### Go

```go
package main

import (
	"fmt"
	"log"

	"github.com/vantafin/vantafin-go"
)

func main() {
	client := vantafin.NewClient("vf-live-your_api_key")

	result, err := client.GetQuote("AAPL")
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(result)
}
```

### Java

```java
import com.vantafin.RestClient;

public class Example {
    public static void main(String[] args) throws Exception {
        RestClient client = new RestClient("vf-live-your_api_key");

        Object result = client.getQuote("AAPL");

        System.out.println(result);
    }
}
```

### Ruby

```ruby
require "vantafin"

client = Vantafin::RestClient.new("vf-live-your_api_key")

result = client.get_quote("AAPL")

pp result
```