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

# CerebroChain Supply Chain & Market Data API

The CerebroChain API is a credit-metered marketplace where bots and agents buy data and AI compute. It runs AI inference and returns basic and premium market intelligence, and it serves real-time crypto and forex prices and live shipping rates sourced from upstream providers. A bot registers against a CerebroChain account to receive an API key, deposits USDC for credits, and then each call draws down credits at a per-call price. Market data, logistics rates, intelligence, and inference each have their own endpoint.

## For AI agents

Register a bot, deposit credits, then run AI inference and pull basic or premium market intelligence, real-time crypto and forex prices, and shipping rates. Registration uses a CerebroChain account bearer token; metered calls use the bot's X-API-Key.

## Scope

Does not execute trades, custody funds beyond credit deposits, or ship goods. Use for metered market data, AI market intelligence, and inference compute only.

## Capabilities

- Run AI inference compute and draw down credits per call
- Return basic or premium AI market analysis
- Fetch real-time crypto prices for an agent to act on
- Fetch forex rates for currency decisions
- Fetch live shipping rates for logistics planning
- Register a bot and deposit USDC credits against its balance

## Use cases

### Metered AI Compute for Agents

An agent registers once against a CerebroChain account, deposits USDC for credits, then calls AI inference and premium market intelligence through Jentic, with each call drawing down the credit balance. Registration carries the account bearer token while metered calls carry the bot's X-API-Key, and a rule can keep the agent on the data and inference reads it needs. The agent finds each operation by intent and calls it directly.

Example prompt: Run an inference request for a market question and read the premium analysis, drawing down credits.

### Real-Time Market and Logistics Data

A trading or operations agent pulls real-time crypto and forex prices and live shipping rates to feed its decisions. CerebroChain sources these from upstream providers and bills each read as credits, so an agent only pays for the data it uses. The crypto, forex, and logistics feeds each have their own endpoint.

Example prompt: Fetch the latest crypto price and a forex rate, then compute a converted value for the agent.

### Supply-Chain Market Intelligence

A supply-chain workflow combines live shipping rates with basic and premium market intelligence to time purchases and shipments. Each call is credit-metered, and premium analysis runs an AI model over current market inputs. Teams use this to turn raw feeds into a recommendation inside an agent run.

Example prompt: Pull shipping rates for a route and request premium market analysis, then summarize the trade-off for the agent.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/bot-marketplace/register` | Register a bot and get an API key |
| GET | `/bot/data/market/crypto` | Get real-time crypto prices |
| GET | `/bot/data/market/forex` | Get forex rates |
| GET | `/bot/data/logistics/rates` | Get live shipping rates |
| GET | `/bot/intelligence/premium` | Get premium AI market analysis |
| POST | `/bot/compute/inference` | Run AI inference compute |

## Key resources

- **Bot registration and credits** — Register a bot for an API key with an account token and deposit USDC for credits
- **Market data** — Real-time crypto prices and forex rates, each metered per call
- **Logistics** — Live shipping rates for a route
- **Intelligence and inference** — Basic and premium AI market analysis and AI inference compute

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 65 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 100 / 100
  - Developer Experience & Jentic Compatibility: 61 / 100
  - AI-Readiness & Agent Experience: 47 / 100
  - Agent Usability: 94 / 100
  - Security: 63 / 100
  - AI Discoverability: 59 / 100
- **View full report:** https://jentic.com/apis/cerebrochain.com/cerebrochain/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the CerebroChain API by hand means juggling two credentials, a CerebroChain account bearer token to register a bot and the bot's `X-API-Key` for metered calls, plus tracking credit balances per request. Through Jentic you install once, import CerebroChain from the API Directory, store both once, and your agent calls it.
- **Permission scoping:** CerebroChain gives each operation its own endpoint, so a rule can bound your agent to the data and intelligence reads it needs, such as crypto, forex, and premium analysis. You choose the operations it may call, so registering bots or depositing credits is not included unless you add it.
- **Credential handling:** Your CerebroChain account token and bot key are stored once, encrypted, by your own Jentic One instance and injected at execution time. Neither enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'get the crypto price' or 'run AI inference', and Jentic returns the matching CerebroChain operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related APIs

- **CoinGecko** — Free and paid crypto market data for prices and market stats.
- **Alpha Vantage** — Stock, forex, and crypto time-series market data.
- **OpenAI** — General language models for reasoning over the data you fetch.

## FAQ

### What authentication does the CerebroChain API use?

The CerebroChain API uses two credentials, per its OpenAPI spec. Registering a bot requires a CerebroChain account bearer token (a JWT) in the Authorization header, and after registration the bot's own key is sent in the `X-API-Key` header on the data, intelligence, and inference calls. Through Jentic both are stored encrypted by your own Jentic One instance and injected at call time.

### Can I run AI inference and pull market data with the CerebroChain API?

Yes. You can run AI inference compute, request basic or premium market analysis, and fetch real-time crypto prices, forex rates, and live shipping rates. Each call draws down credits you deposit as USDC.

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

The OpenAPI spec does not specify rate limits for the CerebroChain API; usage is governed by your credit balance, where each call has its own per-call price. Check the vendor's documentation at https://cerebrochain.com for current pricing and any limits.

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

Yes. Write a rule that allows only the data and intelligence reads your agent needs, such as crypto prices and premium analysis, and leave out registering bots or depositing credits. Every call draws down your credit balance and is logged, and the agent never sees either credential.

### Is there a CerebroChain MCP server?

You don't need an MCP server to give your agent the CerebroChain API. Jentic connects it directly from the API Directory: import it, store your account token and bot key once, and your agent calls the data, intelligence, and inference operations. You skip loading another server's tool definitions into the agent's context.

### How do I fetch market data through Jentic?

Add the CerebroChain API from the Jentic API Directory and store your account token and bot key once. Your agent then searches by intent such as 'get real-time crypto prices' and Jentic returns the matching operation with its input schema, so it can read the price and draw down credits. To run it on your own infrastructure, install Jentic One from its GitHub repo.
