Octodamus Agent Data v2 API
The Agent Data v2 API from Octodamus — 12 operation(s) for agent data v2.
The Agent Data v2 API from Octodamus — 12 operation(s) for agent data v2.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/octodamus-com:octodamus-com-agent-data-v2-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: OctoData Agent Data v2 API
description: AI-powered market intelligence by Octodamus (@octodamusai)
contact:
name: Octodamus
url: https://octodamus.com/
email: octodamusai@gmail.com
version: 3.0.0
security: []
tags:
- name: Agent Data v2
paths:
/v2/signal:
get:
tags:
- Agent Data v2
summary: V2 Signal
description: 'Current Oracle trading signals. 9/11 system consensus required to publish.
**Basic response example:**
```json
{
"signal": {"asset": "BTC", "direction": "LONG", "timeframe": "1W", "opened_at": "2025-01-15T08:00:00"},
"more_signals": 2,
"track_record": {"wins": 12, "losses": 5, "win_rate": 70.6, "total": 17}
}
```
**Premium adds:** `confidence`, `entry_price`, `target_price`, `reasoning` for every signal.
Upgrade: `https://octodamus.com/api#pricing`'
operationId: v2_signal_v2_signal_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
security: []
/v2/agent-signal:
get:
tags:
- Agent Data v2
summary: V2 Agent Signal
description: '**Structured signal pack for AI agents — poll every 15 minutes.**
Returns the single most actionable piece of intelligence Octodamus has right now:
top Oracle signal, Fear & Greed index, BTC price + trend, and top Polymarket edge plays.
Designed for autonomous agents on Virtuals, x402, and Base that need a one-call
decision input without parsing multiple endpoints.
```json
{
"action": "BUY",
"confidence": "high",
"signal": {"asset": "BTC", "direction": "LONG", "timeframe": "1W"},
"fear_greed": {"value": 17, "label": "Extreme Fear"},
"btc": {"price_usd": 82400, "change_24h": 4.1, "trend": "UP"},
"polymarket_edge": [
{"question": "Will BTC hit $90k before May?", "side": "NO", "ev": 0.18, "confidence": "high"}
],
"reasoning": "Extreme fear + LONG signal + macro dip = accumulation zone.",
"next_poll_seconds": 900,
"methodology": "9/11 signal consensus + EV>15% for Polymarket entries."
}
```'
operationId: v2_agent_signal_v2_agent_signal_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
security: []
/v2/x402/agent-signal:
get:
tags:
- Agent Data v2
summary: x402 agent signal — pay $0.01 USDC on Base
description: 'x402-native agent signal endpoint. Requires PAYMENT-SIGNATURE header (EIP-3009 USDC on Base).
$0.01/call micro or $29/year annual. Bazaar-discoverable via 402 + extension headers.
Optional `asset` query param (BTC|ETH|SOL) scopes the primary signal.'
operationId: v2_x402_agent_signal_v2_x402_agent_signal_get
parameters:
- name: asset
in: query
required: false
schema:
type: string
description: 'Asset to scope the signal to: BTC, ETH, or SOL.'
default: BTC
title: Asset
description: 'Asset to scope the signal to: BTC, ETH, or SOL.'
responses:
'200':
description: Signed BUY/SELL/HOLD signal pack (Ed25519).
content:
application/json:
schema: {}
'402':
description: Payment Required — x402 challenge (EIP-3009 USDC on Base). Sign the authorization and retry with the PAYMENT-SIGNATURE header.
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- x402Payment: []
x-payment-info:
protocols:
- x402
price:
mode: fixed
currency: USD
amount: '0.01'
network: base
asset: USDC
payTo: '0x5c6B3a3dAe296d3cef50fef96afC73410959a6Db'
/v2/polymarket:
get:
tags:
- Agent Data v2
summary: V2 Polymarket
description: 'OctoBoto Polymarket positions. Entry rule: EV > 15%. Mode: paper trading.
**Basic response example:**
```json
{
"top_play": {"question": "Will BTC hit $100k by March?", "side": "YES", "url": "polymarket.com/..."},
"total_plays": 3,
"track_record": {"wins": 7, "losses": 3, "closed": 10, "mode": "paper"}
}
```
**Premium adds:** `entry_price`, `true_p`, `ev`, `size_usd` for all positions.
Upgrade: `https://octodamus.com/api#pricing`'
operationId: v2_polymarket_v2_polymarket_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
security: []
/v2/sentiment:
get:
tags:
- Agent Data v2
summary: V2 Sentiment
description: 'AI sentiment scores (-100 bearish to +100 bullish). Updated nightly at 00:30 UTC.
**Basic response example:**
```json
{
"BTC": {"score": 42, "label": "bullish", "drivers": ["ETF inflows", "low funding rates"]},
"more_assets": ["ETH", "SOL", "NVDA", "TSLA", "AAPL"]
}
```
**Premium adds:** ETH, SOL, NVDA, TSLA, AAPL with full driver breakdown.
Upgrade: `https://octodamus.com/api#pricing`'
operationId: v2_sentiment_v2_sentiment_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
security: []
/v2/sentiment/{symbol}:
get:
tags:
- Agent Data v2
summary: V2 Sentiment Symbol
description: 'Per-asset sentiment score. Symbol: BTC, ETH, SOL, NVDA, TSLA, AAPL.'
operationId: v2_sentiment_symbol_v2_sentiment__symbol__get
security: []
parameters:
- name: symbol
in: path
required: true
schema:
type: string
title: Symbol
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v2/prices:
get:
tags:
- Agent Data v2
summary: V2 Prices
description: 'Latest asset price snapshots with 24h change. Nightly + live on demand.
**Basic response example:**
```json
{
"prices": {
"BTC": {"price_usd": 94500, "change_24h_pct": 2.1, "market_cap": 1870000000000},
"ETH": {"price_usd": 3200, "change_24h_pct": 1.4},
"SOL": {"price_usd": 178, "change_24h_pct": -0.8}
}
}
```
**Premium adds:** NVDA, TSLA, AAPL.
Upgrade: `https://octodamus.com/api#pricing`'
operationId: v2_prices_v2_prices_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
security: []
/v2/brief:
get:
tags:
- Agent Data v2
summary: V2 Brief
description: 'One-paragraph market brief — optimized for agent context windows and system prompts.
**Basic response example:**
```json
{
"brief": "Oracle top signal: BTC LONG 1W. Methodology: 9/11 signal consensus required.",
"top_signal": "BTC LONG",
"tier": "basic"
}
```
**Premium adds:** Full AI-written brief with macro context, Polymarket positions, and AI mood.
Upgrade: `https://octodamus.com/api#pricing`'
operationId: v2_brief_v2_brief_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
security: []
/v2/all:
get:
tags:
- Agent Data v2
summary: V2 All
description: '**All v2 data in one call — saves 4 requests.**
Returns signal + polymarket + sentiment + prices + brief in a single response.
Ideal for agents that need full market context in one round-trip.
Rate limit counts as 1 request.
Basic: same field restrictions as individual endpoints.
Premium: full data across all fields.'
operationId: v2_all_v2_all_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
security: []
/v2/ask:
post:
tags:
- Agent Data v2
summary: V2 Ask
description: '**Talk to Octodamus directly — no API key required to try.**
Ask any market question. Octodamus responds grounded in live data and will point
you to the exact API endpoints that automate what you''re asking.
Free: 20 questions/day per IP. With a key: 200/day.
**Example questions:**
- "What''s your current read on BTC?"
- "Do you have any open signals right now?"
- "What Polymarket positions are you holding?"
- "How do I inject live market context into my agent''s system prompt?"
- "What''s the Fear & Greed index right now?"
- "Which endpoint should I use if I just want a one-line market summary?"
Get a free key: `POST https://api.octodamus.com/v1/signup?email=your@email.com`'
operationId: v2_ask_v2_ask_post
security: []
parameters:
- name: q
in: query
required: true
schema:
type: string
description: Your question for Octodamus
title: Q
description: Your question for Octodamus
- name: context
in: query
required: false
schema:
type: string
description: 'Optional: describe your agent or use case (helps tailor the answer)'
default: ''
title: Context
description: 'Optional: describe your agent or use case (helps tailor the answer)'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v2/demo:
get:
tags:
- Agent Data v2
summary: V2 Demo
description: '**Public demo — no API key required.**
Live sample of every v2 endpoint. Basic fields shown for all; Premium fields
are present but redacted with `"[premium]"` so agents can see the schema.
Get a free key: `POST https://api.octodamus.com/v1/signup?email=your@email.com`'
operationId: v2_demo_v2_demo_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
security: []
/v2/sources:
get:
tags:
- Agent Data v2
summary: V2 Sources
description: '**Data sources — no API key required.**
Every data feed powering each OctoData endpoint. For agent trust verification
and due diligence. All sources are live; no synthetic or simulated data.'
operationId: v2_sources_v2_sources_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
security: []
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
securitySchemes:
x402Payment:
type: apiKey
in: header
name: PAYMENT-SIGNATURE
description: x402 pay-per-call on Base. Sign an EIP-3009 USDC authorization and send as this header. No signup required. See api.octodamus.com/v2/demo for a free preview.
ApiKeyAuth:
type: apiKey
in: header
name: X-OctoData-Key
description: Annual API key from api.octodamus.com/v1/signup (free Basic tier available).
x-discovery:
protocols:
- x402
network: base