# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/signalstart/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/signalstart/get-signal-charts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/signalstart/get-signal-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/signalstart/get-signal-history \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/signalstart/list-signals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/signalstart/search-signals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.