# All Tickers

`GET` `/v1/companydata/tickers`

Retrieve the full universe of tickers Vantafin tracks - common stocks, ETFs and funds - with optional filters for type, name search and cursor-based pagination. Each row includes the ticker, company name, CIK, ISIN, CUSIP (null when unavailable), exchange and security type so you can build ticker pickers, validate inputs or walk the entire universe without loading every profile individually. Use the returned next_cursor to page forward until you have every ticker you need.

## Use cases

- Building a searchable ticker directory or autocomplete in your app
- Syncing your local ticker master with Vantafin’s coverage
- Filtering to stocks, ETFs or funds for screener universes
- Bulk jobs that need to iterate every supported ticker

## Input parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `search` | string | No | Filter by ticker or company name substring. |
| `type` | string | No | Filter by 'stock', 'etf', or 'fund'. |
| `cursor` | string | No | Return tickers strictly after this ticker (pagination). |
| `limit` | integer | No | Max results, 1-1000 (default 100). |

## Output parameters

| Name | Type | Description |
| --- | --- | --- |
| `results` | array | Ticker rows for this page. |
| `results[].ticker` | string | Ticker. |
| `results[].company` | string | Company or fund name. |
| `results[].cik` | string | SEC Central Index Key; null when unavailable. |
| `results[].isin` | string | International Securities Identification Number; null when unavailable. |
| `results[].cusip` | string | CUSIP identifier; null when unavailable. |
| `results[].exchange` | string | Primary listing exchange. |
| `results[].type` | string | Security type: stock, etf, or fund. |
| `count` | integer | Number of rows in this response. |
| `next_cursor` | string | Pass as cursor to fetch the next page; omitted when done. |

## Example response

```json
{
  "results": [
    {
      "ticker": "A",
      "company": "Agilent Technologies, Inc.",
      "cik": "0001090872",
      "isin": "US00846U1016",
      "cusip": "00846U101",
      "exchangeShort": "NYSE",
      "logo": "https://company-logos.vantafin.com/A.png"
    },
    {
      "ticker": "AA",
      "company": "Alcoa Corporation",
      "cik": "0001675149",
      "isin": "US0138721065",
      "cusip": "013872106",
      "exchangeShort": "NYSE",
      "logo": "https://company-logos.vantafin.com/AA.png"
    }
  ],
  "count": 100,
  "next_cursor": "ADAMN"
}
```

## Examples

### cURL

```bash
curl "https://api.vantafin.com/v1/companydata/tickers?type=stock&limit=100&apiKey=$VANTAFIN_API_KEY"
```

### Python

```python
from vantafin import RESTClient

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

result = client.list_tickers(type="stock", limit=100)

print(result)
```

### JavaScript

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

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

const result = await client.listTickers({ type: "stock", limit: 100 });

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.ListTickers(vantafin.Params{"type": "stock", "limit": 100})
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(result)
}
```

### Java

```java
import com.vantafin.RestClient;
import com.vantafin.Params;

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

        Object result = client.listTickers(Params.of().set("type", "stock").set("limit", 100));

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

### Ruby

```ruby
require "vantafin"

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

result = client.list_tickers(type: "stock", limit: 100)

pp result
```