canonical: https://jentic.com/apis/bravenewcoin.com/bravenewcoin

# BraveNewCoin API

Jentic publishes the only available OpenAPI specification for BraveNewCoin API, keeping it validated and agent-ready. BraveNewCoin is a cryptocurrency market data provider distributed via RapidAPI, exposing nine endpoints for asset metadata, exchange directories, market lookups, market-cap snapshots, and OHLCV time series. Authentication is the standard RapidAPI pair of X-RapidAPI-Key plus X-RapidAPI-Host headers, with a separate JWT obtained from /oauth/token used as a bearer for protected endpoints. The data set covers thousands of crypto assets and the exchanges that trade them, suitable for portfolio dashboards, alerting bots, and quantitative research feeds.

## For AI agents

Look up cryptocurrency assets, exchanges, market cap, and OHLCV price history for portfolio dashboards and price alerts via BraveNewCoin's nine RapidAPI endpoints.

## Scope

Does not handle order execution, custody, or wallet transfers - use for read-only crypto asset, market, exchange, and OHLCV market-data lookups only.

## Capabilities

- List supported crypto assets via GET /asset and resolve a single asset's metadata via GET /asset/{assetId}
- Retrieve OHLCV (open/high/low/close/volume) candles for an asset and market through GET /ohlcv
- Pull current market-capitalization snapshots across the universe via GET /market-cap
- Look up specific markets and the assets quoted on them via GET /market and GET /market/{marketId}
- Enumerate exchanges that trade tracked assets via GET /exchange and GET /exchange/{exchangeId}
- Mint a JWT for protected endpoints via POST /oauth/token using the RapidAPI subscription key

## Use cases

### Crypto portfolio dashboard pricing

Power a portfolio dashboard that shows live values and 24-hour changes by mapping each holding to a BraveNewCoin assetId and pulling the latest market-cap and OHLCV data. Use GET /asset/{assetId} for the symbol and metadata, then GET /ohlcv for the latest close to compute current value, all through one RapidAPI subscription.

Example prompt: For each holding, call GET /asset/{assetId} to confirm the symbol, then GET /ohlcv with that assetId and timeframe='1d' and return the latest close price.

### Price-alert bot for retail crypto traders

Build a Telegram or Discord bot that pings users when an asset crosses a threshold. Poll GET /ohlcv for the recent candle, compare close to the user's target, and notify when crossed. The /market and /exchange endpoints let users pin alerts to a specific venue rather than a global aggregate price.

Example prompt: Every 60 seconds, GET /ohlcv with assetId='BTC' and marketId='BTC-USD-Coinbase', take the last candle close, and if close >= 70000 send a message to the user.

### Quantitative research data feed

Feed historical candles into a backtesting or signal-research pipeline by paging GET /ohlcv across asset and market combinations. Combine with GET /exchange for venue metadata and GET /market-cap for market-cap-weighted universe construction. Suitable for Jupyter-based research before committing to a paid tick-data provider.

Example prompt: Iterate the asset list from GET /asset, then for each asset call GET /ohlcv with timeframe='1h' to assemble a panel of hourly candles for the last 30 days.

### AI agent integration via Jentic

An agent that needs to answer 'what is the price of X?' or build a quick portfolio summary can discover BraveNewCoin through Jentic, load the right asset or OHLCV operation, and execute it without holding the RapidAPI key in its prompt context. Jentic keeps the X-RapidAPI-Key and X-RapidAPI-Host headers in the vault and attaches them at execution time.

Example prompt: Through Jentic, search 'get the current price of a cryptocurrency', load the operation that targets GET /ohlcv, and execute with assetId and timeframe supplied by the user query.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /asset | List supported crypto assets |
| GET | /asset/{assetId} | Retrieve metadata for a single asset |
| GET | /ohlcv | Fetch open/high/low/close/volume candles |
| GET | /market-cap | Retrieve market-capitalization snapshots |
| GET | /market | List supported trading markets |
| GET | /exchange | List exchanges tracked by BraveNewCoin |
| POST | /oauth/token | Mint a JWT for protected endpoints |

## Key resources

- **Assets** — Crypto asset metadata - list and retrieve individual assets via /asset and /asset/{assetId}
- **Markets** — Trading markets (e.g. BTC-USD on Coinbase) via /market and /market/{marketId}
- **Exchanges** — Exchange directory and per-exchange details via /exchange and /exchange/{exchangeId}
- **OHLCV** — Historical and recent open/high/low/close/volume candles via /ohlcv
- **Market cap** — Aggregate market-capitalization snapshots via /market-cap
- **OAuth token** — JWT minted at POST /oauth/token for protected endpoints

## Why Jentic

- **Setup:** Wiring BraveNewCoin by hand means setting the X-RapidAPI-Key and X-RapidAPI-Host headers, optionally exchanging an oauth/token JWT, and threading all of that through the read-only market-data calls. Through Jentic you install once, import the BraveNewCoin API from the API Directory, store the credentials once, and your agent calls it.
- **Permission scoping:** BraveNewCoin is read-only market data and takes its asset id in the URL path (/asset/{assetId}) while other lookups use the query string, so scope the agent to the read operations it needs, such as fetching OHLCV or listing exchanges. Every operation you allow is one you have explicitly chosen, and none of them execute trades or move funds.
- **Credential handling:** Your BraveNewCoin RapidAPI key and host, and any JWT, are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'get the current price of a cryptocurrency' or 'list crypto exchanges', and Jentic returns the matching BraveNewCoin operation with its input schema and the RapidAPI host pre-wired so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Braintree GraphQL API** — Use Braintree to handle fiat payment processing alongside BraveNewCoin's crypto market data
- **Breadcrumbs API** — Score crypto-product leads in Breadcrumbs based on market signals retrieved from BraveNewCoin
- **Braze API** — Send price-movement notifications via Braze using thresholds computed from BraveNewCoin data

## FAQ

### Why is there no official OpenAPI spec for BraveNewCoin API?

BraveNewCoin distributes the API through RapidAPI and does not publish a standalone OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call BraveNewCoin API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the BraveNewCoin API use?

Most endpoints require the standard RapidAPI headers: X-RapidAPI-Key (your subscription key) and X-RapidAPI-Host set to bravenewcoin.p.rapidapi.com. Protected endpoints additionally require a JWT bearer minted at POST /oauth/token. Through Jentic, all three credentials live in the encrypted vault.

### Can I get historical OHLCV candles from the BraveNewCoin API?

Yes. GET /ohlcv returns open/high/low/close/volume candles for a given assetId and optional marketId and timeframe. Use it for both recent live pricing and historical lookback for backtests; pagination parameters limit how many candles are returned per call.

### What are the rate limits for the BraveNewCoin API?

Rate limits are set by the RapidAPI subscription tier you purchase, not the OpenAPI spec - check your plan in the RapidAPI dashboard for monthly request quotas and burst limits before scaling polling jobs against /ohlcv or /market-cap.

### How do I fetch a current crypto price with the BraveNewCoin API through Jentic?

Install the SDK with pip install jentic, then await client.search('get the current price of a cryptocurrency'), await client.load on the GET /ohlcv operation, and await client.execute with assetId and timeframe='1d'. Read the latest candle's close field as the price.

### Does the BraveNewCoin API cover all major exchanges?

GET /exchange enumerates the exchanges BraveNewCoin tracks and GET /market lists the trading pairs available across them. Coverage varies by venue - call /exchange first to confirm the venue you need is supported before pinning OHLCV calls to a specific marketId.

### Can I limit what my agent is allowed to do with the BraveNewCoin API?

Yes. Because Jentic One is self-hosted, your own rules decide which BraveNewCoin operations and credentials your agent may use, so you can grant only the read calls it needs, such as GET /ohlcv for candles, GET /asset for asset lookups, or GET /exchange to list venues. Every operation you allow is one you have explicitly chosen, and the API is read-only market data, so none of these calls execute trades or move funds. You can also withhold POST /oauth/token and the RapidAPI key so the agent never mints or holds credentials it does not require.