# Starchild Relay – TwelveData Real-Time Price

> Starchild Relay – TwelveData Real-Time Price is a paid API for AI agents from 5108-data-api-proxy.community.iamstarchild.com, paid per call via x402, $0.00001/call, status unknown (last checked 2026-09-13).

Returns the current spot price for a given ticker symbol (stock, forex, crypto, or index) via the TwelveData upstream, behind an x402 micropayment paywall.

## Facts

- Endpoint: POST https://5108-data-api-proxy.community.iamstarchild.com/twelvedata/price
- Price: $0.00001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/starchild-relay-twelvedata-real-time-price-11a509f6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QUd3LQ9n_w6tVZZKvAThF

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability starchild-relay-twelvedata-real-time-price-11a509f6 -d '<json body>'
```

Example prompt: What's the current price of AAPL right now? Pull it from TwelveData through the Starchild Relay.

## When to prefer this

Choose this endpoint when you need a real-time single spot price for a stock, forex pair, crypto, or index via TwelveData, and you are operating in an x402 micropayment environment. It is ideal for lightweight, per-call price lookups without a long-term API key subscription. Prefer it over raw TwelveData if you want to consolidate financial data access under a single x402 paywall gateway.

## Known failure modes

- 402 Payment Required – no or invalid X-PAYMENT header; agent must complete x402 payment challenge
- Invalid or unrecognized ticker symbol returns an error from TwelveData upstream
- Upstream TwelveData outage or rate limit may cause 5xx or timeout
- Missing required 'symbol' field in request body causes validation error

## How this service works

All-in-one reputable data source for AI agents and developers. Crypto spot/OHLC, derivatives funding rates, open interest, liquidations, forex, commodities, indices, social sentiment, DeFi protocols, and more — 17+ upstream data sources behind a single x402 paywall.

Usage: Send requests to any proxied path (e.g. GET /coingecko/api/v3/...). Unauthenticated requests receive a 402 challenge with payment instructions. Include X-PAYMENT header with a valid signature to access data.

## Output

A JSON response containing the current spot price for the requested ticker symbol, sourced from TwelveData. Typically includes the symbol and its latest traded price.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "symbol": {
   "type": "string",
   "description": "Ticker symbol (e.g. AAPL, EUR/USD)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/starchild-relay-twelvedata-real-time-price-11a509f6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 5108-data-api-proxy.community.iamstarchild.com](https://www.zero.xyz/host/5108-data-api-proxy.community.iamstarchild.com/llms.txt)
