# Signalstart — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Browse and search forex signals from SignalStart.com to access performance metrics, trade history, and historical growth charts. Compare signal details to make informed trading decisions based on real performance data.

**Category:** Finance & Markets | **Website:** [signalstart.com/](https://signalstart.com/) | **Docs:** [parse.bot/marketplace/7dbbae15-2754-4fbb-bb9b-7b74264ee638/signalstart-com-api](https://parse.bot/marketplace/7dbbae15-2754-4fbb-bb9b-7b74264ee638/signalstart-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-signalstart-com-api-7dbbae15/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_signal_charts

Retrieve historical chart data for a signal. Supports daily growth (type 1), monthly yield (type 3), or symbols distribution (type 6). Daily growth returns timestamped equity/growth percentage pairs. The content object contains JSON-encoded dailyGrowthData, funds arrays, creation date, date labels, currency, and anchor size.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `chart_type` | integer | No | Chart type. |
| `id` | string | Yes | Signal account OID (numeric string from list_signals results, e.g. '288562'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-signalstart-com-api-7dbbae15/get_signal_charts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chart_type":"<integer>","id":"<string>"}'
```

### get_signal_details

Retrieve full details and advanced statistics for a specific signal. Includes balance, equity, floating P/L, deposits, withdrawals, advanced performance metrics (win rate, profit factor, daily/monthly returns, expectancy), and provider information. Requires both the signal slug and numeric OID from list_signals results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Signal account OID (numeric string from list_signals results, e.g. '288562'). |
| `slug` | string | Yes | Signal name slug (from list_signals results, e.g. 'valeron-elite'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-signalstart-com-api-7dbbae15/get_signal_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"<string>","slug":"<string>"}'
```

### get_signal_history

Retrieve paginated trade history for a signal. Returns the 10 most recent closed trades per page, ordered by close date descending. Each trade includes open/close timestamps, symbol, action (Buy/Sell), lot size, prices, stop loss, take profit, pips gained, profit amount, duration, and gain percentage.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Signal account OID (numeric string from list_signals results, e.g. '288562'). |
| `page` | integer | No | Page number (1-indexed). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-signalstart-com-api-7dbbae15/get_signal_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"<string>","page":"<integer>"}'
```

### list_signals

Retrieve the ranked list of forex signals with filtering and sorting support. Returns paginated results ordered by the specified column. Each signal includes rank, gain, pips, drawdown, trades count, price, age, and embedded sparkline data (monthly performance and daily growth arrays). Default ordering is by rank ascending.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-indexed). |
| `page_size` | integer | No | Number of signals per page. |
| `search` | string | No | Filter signals by name or keyword. Omitting returns all signals. |
| `sort_by` | integer | No | Column ID to sort by. |
| `sort_type` | integer | No | Sort order. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-signalstart-com-api-7dbbae15/list_signals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>","search":"<string>","sort_by":"<integer>","sort_type":"<integer>"}'
```

### search_signals

Search for signals by keyword or provider name. Returns matching signals ranked by default ordering. Equivalent to list_signals with a search filter applied. Returns all matches in a single page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to filter signals by name. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-signalstart-com-api-7dbbae15/search_signals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```
