# All Insider Transactions

`GET` `/v1/insider-transactions`

Retrieve the latest SEC Form 4 insider purchase and sale transactions across all supported tickers - the same schema as Insider Transactions by Ticker but with a ticker on each row so you can build market-wide insider feeds without querying every symbol. Pagination via page and limit (default 50, max 250). Purchases and sales only.

## Use cases

- Market-wide insider activity feeds on home dashboards
- Cross-ticker insider buying and selling monitors
- Morning research on notable officer and director trades
- Alerting pipelines that scan all recent Form 4 activity

## Input parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | integer | No | Zero-based page (default 0). |
| `limit` | integer | No | Page size, 1-250 (default 50). |

## Output parameters

| Name | Type | Description |
| --- | --- | --- |
| `results` | array | Form 4 insider transactions across all tickers (purchases and sales). |
| `results[].ticker` | string | Ticker for the transaction. |
| `results[].insiderName` | string | Reporting person name. |
| `results[].relationship` | string | Officer, director, or other relationship. |
| `results[].transactionDate` | string | Transaction date (YYYY-MM-DD). |
| `results[].transactionType` | string | Purchase or Sale. |
| `results[].price` | float | Transaction price per share. |
| `results[].shares` | integer | Shares transacted. |
| `results[].value` | float | Total transaction value. |
| `results[].sharesOwnedFollowing` | integer | Shares owned after the transaction. |
| `results[].filingId` | string | SEC filing accession id. |
| `results[].filedAt` | string | Filing timestamp (ISO 8601). |
| `count` | integer | Number of rows on this page. |
| `total` | integer | Total matching transactions. |
| `page` | integer | Zero-based page index. |

## Example response

```json
{
  "results": [
    {
      "ticker": "AAPL",
      "insiderName": "Borders Ben",
      "relationship": "officer: Principal Accounting Officer",
      "transactionDate": "2026-05-08",
      "transactionType": "Sale",
      "price": 290,
      "shares": 1274,
      "value": 369460,
      "sharesOwnedFollowing": 38713,
      "filingId": "0000320193_000114036126020871",
      "filedAt": "2026-05-12"
    },
    {
      "ticker": "MSFT",
      "insiderName": "SMITH BRADFORD L",
      "relationship": "director",
      "transactionDate": "2026-05-07",
      "transactionType": "Purchase",
      "price": 442.12,
      "shares": 5000,
      "value": 2210600,
      "sharesOwnedFollowing": 85000,
      "filingId": "0001193125_000119312525089876",
      "filedAt": "2026-05-09"
    }
  ],
  "count": 50,
  "total": 128430,
  "page": 0
}
```

## Examples

### cURL

```bash
curl "https://api.vantafin.com/v1/insider-transactions?limit=50&apiKey=$VANTAFIN_API_KEY"
```

### Python

```python
from vantafin import RESTClient

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

result = client.list_insider_transactions(limit=50)

print(result)
```

### JavaScript

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

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

const result = await client.listInsiderTransactions({ limit: 50 });

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.ListInsiderTransactions(vantafin.Params{"limit": 50})
	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.listInsiderTransactions(Params.of().set("limit", 50));

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

### Ruby

```ruby
require "vantafin"

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

result = client.list_insider_transactions(limit: 50)

pp result
```