A crypto-derivatives market-structure data platform. Its REST API, which takes a free bearer key from a verified account, surfaces funding rates/arbitrage, open interest, liquidation maps, options (Deribit), ETF flows, order-flow toxicity (VPIN), Coinbase premium, CFTC COT positioning, and Fear & Greed / BTC-dominance indices. It also offers a hosted MCP server, x402 agent-payment endpoints, and CC0 datasets.
ByKaranteli publishes 5 API contracts indexed on the APIs.io network, including X402 API, Public API, and 3 more. Tagged areas include Cryptocurrency, Crypto Derivatives, Market Data, Funding Rates, and Open Interest.
The ByKaranteli catalog on APIs.io includes 1 Spectral governance ruleset.
ByKaranteli’s developer surface includes pricing, documentation, API reference, getting-started guide, support, signup flow, changelog, and 39 more developer resources.
Regulatory Posture applies to this provider. Its tags matched the
Securities & Market Data regime, so
Regulatory Posture carries 15 points of the composite.
If this regime is wrong for your business, say so on your
provider repo — the
applicability map is public and we will correct it.
Create-or-Update Ergonomics does not apply to this provider. The published contracts declare
no write operations, and a read-only API cannot create-or-update. The facet is excluded from this provider's
denominator entirely — not scored zero. A reference or data API is not deficient for being unable to
upsert.
The six quality facets above are damped to 85 points between them,
because the conditional facet above carries the other
15. That is why each facet's contribution is shown against a damped
maximum: raising a quality facet moves the composite by 85% of its nominal
weight, not 100%. The full arithmetic is at apis.io/rating/.
Show this score on your site.
It updates itself when the score changes. Paste this where you link to your API docs:
<a href="https://apis.io/providers/bykaranteli/"><img src="https://apis.io/badge/bykaranteli/card.svg" alt="ByKaranteli on APIs.io — Kin Score by API Evangelist"></a>
Other styles, a README pill and a shields.io endpoint are on the badge page.
Raise your score.
Agent readiness — checks not met, largest first (exact, from this profile):
Delegated User Identity+6 pts — a served discovery document listing authorization_code in grant_types_supported (served), else an oauth2 authorizationCode flow or openIdConnect declared in an OpenAPI (documented)
Typed Event Surface+6 pts — AsyncAPI document, OR webhooks/callbacks objects in the as-published OpenAPI, OR common[].type includes Webhooks
Protected Resource Metadata+5 pts — a served /.well-known/oauth-protected-resource carrying `resource` (documented), and naming its authorization_servers (verified)
Agentic Commerce Well-Known Document+5 pts — a parsing /.well-known/ucp.json or acp.json declaring a version and at least one service, OR (0.27) a live x402 payment challenge from _data/x402-adoption.json — `self` when its endpoints are on the provider's own domain, `platform` when they are on a vendor's
Well-Known Catalog+4 pts — common[].type includes WellKnown, APICatalog, or api-catalog
1 more unmet check in the Agent Readiness table above.
Kin Score — facets with the most composite points still available (weight × headroom):
The Kin Score Market layer reads a provider inside its market:
its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted:
not part of the Kin Score or agent readiness.
Registered MCP server and declares compatibility are report only — not weighted.
Undeclared means we found nothing we can read, so there is no number: we never infer integrations.
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
Per-call priced history and depth endpoints, settled in USDC over the x402 protocol on Solana and Base mainnet through the Coinbase CDP facilitator. 13 priced endpoints plus the...
The free, no-key public REST surface — 10 endpoints under /api/v1/public/ described by the provider's own self-describing manifest, plus the /api/public/ index endpoints. Verifi...
Overlays applied on top of this provider's contracts. Each card says who wrote it: a document the provider publishes, or one API Evangelist derived or generated.
name: ByKaranteli
description: A crypto-derivatives market-structure data platform. Its REST API, which takes a free bearer key from a verified
account, surfaces funding rates/arbitrage, open interest, liquidation maps, options (Deribit), ETF flows, order-flow toxicity
(VPIN), Coinbase premium, CFTC COT positioning, and Fear & Greed / BTC-dominance indices. It also offers a hosted MCP server,
x402 agent-payment endpoints, and CC0 datasets.
url: https://raw.githubusercontent.com/api-evangelist/bykaranteli/refs/heads/main/apis.yml
deliveryModel:
model: saas
open_source: false
commercial: true
callable_host: true
label: Hosted service · you call their endpoint
confidence: high
source:
- openapi
- pricing
generated: '2026-08-28'
method: derived
accessModel:
pricing: freemium
onboarding: self-serve
trial: false
try_now: true
public: false
gated: none
gated_source:
- onboarding
label: Freemium · Self-serve signup
confidence: high
source:
- plans
- authentication
- rate-limits
- security
generated: '2026-11-06'
method: derived
created: '2026-08-09'
modified: '2026-10-06'
specificationVersion: '0.23'
tags:
- Cryptocurrency
- Crypto Derivatives
- Market Data
- Funding Rates
- Open Interest
- Liquidations
- Options
- ETF Flows
- Financial Data
- MCP
- x402
- Agents
image: https://bykaranteli.com/brand/icon-192.png
maintainers:
- FN: ByKaranteli
email: support@bykaranteli.com
url: https://bykaranteli.com
common:
- type: CapabilityMap
url: capabilities/bykaranteli-capability-edges.yml
name: ByKaranteli Business Capability Map
- type: Plans
url: plans/bykaranteli-plans-pricing.yml
- type: Plans
url: plans/bykaranteli-plans.yml
- type: RateLimits
url: rate-limits/bykaranteli-rate-limits.yml
- type: FinOps
url: finops/bykaranteli-finops.yml
- type: Pricing
url: https://bykaranteli.com/pricing
- url: https://bykaranteli.com/feed.xml
type: BlogRSS
- type: APIsJSON
url: https://bykaranteli.com/apis.json
- type: APIsJSON
url: https://bykaranteli.com/.well-known/apis.json
- type: Spectral
url: rules/bykaranteli-rules.yml
- type: AgentCard
url: a2a/bykaranteli-a2a.yml
- type: Hosts
url: hosts/bykaranteli-hosts.yml
- type: Vendors
url: vendors/bykaranteli-vendors.yml
- type: SDKs
url: packages/bykaranteli-packages.yml
- type: TermsOfService
url: https://bykaranteli.com/terms
- type: Security
url: https://bykaranteli.com/security
- type: PrivacyPolicy
url: https://bykaranteli.com/privacy
- type: Newsroom
url: https://bykaranteli.com/newsroom
- type: VulnerabilityDisclosure
url: security/bykaranteli-vulnerability-disclosure.yml
- type: Website
url: https://www.bykaranteli.com/
- type: MCPServer
url: mcp/bykaranteli-mcp.yml
- type: Documentation
url: https://bykaranteli.com/developers
- type: AgenticAccess
url: agentic-access/bykaranteli-agentic-access.yml
- type: DomainSecurity
url: security/bykaranteli-domain-security.yml
- type: DeveloperPortal
url: https://bykaranteli.com/developers
- type: APIReference
url: https://bykaranteli.com/developers
- type: GettingStarted
url: https://bykaranteli.com/guide
- type: Support
url: https://t.me/bykaranteli_com
- type: GitHubOrganization
url: https://github.com/bykarantelicom
- type: Pricing
url: https://bykaranteli.com/pricing
- type: SignUp
url: https://bykaranteli.com/register
- type: Login
url: https://bykaranteli.com/login
- type: StatusPage
url: https://bykaranteli.com/status
- type: ChangeLog
url: changelog/bykaranteli-changelog.yml
- type: Lifecycle
url: lifecycle/bykaranteli-lifecycle.yml
- type: Authentication
url: authentication/bykaranteli-authentication.yml
- type: Conventions
url: conventions/bykaranteli-conventions.yml
- type: ErrorCatalog
url: errors/bykaranteli-problem-types.yml
- type: RateLimits
url: rate-limits/bykaranteli-rate-limits.yml
- type: Plans
url: plans/bykaranteli-plans.yml
- type: FinOps
url: finops/bykaranteli-finops.yml
- type: Packages
url: packages/bykaranteli-packages.yml
- type: Conformance
url: conformance/bykaranteli-conformance.yml
- type: Vocabulary
url: vocabulary/bykaranteli-vocabulary.yml
- type: Components
url: components/bykaranteli-components.yml
- type: AgentSkill
url: skills/_index.yml
apis:
- aid: bykaranteli:bykaranteli-x402-api
name: ByKaranteli X402 API
description: 'Per-call priced history and depth endpoints, settled in USDC over the x402 protocol on Solana and Base mainnet
through the Coinbase CDP facilitator. 13 priced endpoints plus the free catalog at /api/x402, which is the authoritative
price list. Verified 2026-08-11: the catalog lists 13 endpoints from $0.002 to $0.010, and a priced endpoint returns HTTP
402. These sell depth and history, never access.'
humanURL: https://bykaranteli.com/developers
tags:
- x402
tags_raw:
- X402
properties:
- type: OpenAPI
url: openapi/bykaranteli-x402-api-openapi.yml
- type: Overlay
url: overlays/bykaranteli-x402-overlay.yaml
- type: Examples
url: examples/_index.yml
- type: Documentation
url: https://bykaranteli.com/developers
- type: LLMsTxt
url: llms/bykaranteli-llms.txt
- type: ToolCrosswalk
url: mcp/bykaranteli-tool-crosswalk.yml
- type: APICatalog
url: well-known/bykaranteli-public-manifest.json
- aid: bykaranteli:bykaranteli-public-api
name: ByKaranteli Public API
description: 'The free, no-key public REST surface — 10 endpoints under /api/v1/public/ described by the provider''s own
self-describing manifest, plus the /api/public/ index endpoints. Verified 2026-08-11: unauthenticated, HTTP 200, `access-control-allow-origin:
*`, 5-minute cache. NO OpenAPI is registered for this surface because the provider does not publish one — their openapi.json
covers the x402 endpoints only. The manifest below is the machine-readable description that does exist; nothing here is
reconstructed.'
humanURL: https://bykaranteli.com/developers
tags:
- Market Data
properties:
- type: Documentation
url: https://bykaranteli.com/developers
- type: APICatalog
url: well-known/bykaranteli-public-manifest.json
- aid: bykaranteli:bykaranteli-public-api
name: ByKaranteli Public API
description: The Public API from ByKaranteli — 68 operation(s) for public.
humanURL: https://bykaranteli.com/developers
baseURL: https://bykaranteli.com
tags:
- Public
properties:
- type: OpenAPI
url: openapi/bykaranteli-public-api-openapi.yml
- aid: bykaranteli:bykaranteli-series-api
name: ByKaranteli Series API
description: The Series API from ByKaranteli — 2 operation(s) for series.
humanURL: https://bykaranteli.com/developers
baseURL: https://bykaranteli.com
tags:
- Series
properties:
- type: OpenAPI
url: openapi/bykaranteli-series-api-openapi.yml
- aid: bykaranteli:bykaranteli-usage-api
name: ByKaranteli Usage API
description: The Usage API from ByKaranteli — 1 operation(s) for usage.
humanURL: https://bykaranteli.com/developers
baseURL: https://bykaranteli.com
tags:
- Usage
properties:
- type: OpenAPI
url: openapi/bykaranteli-usage-api-openapi.yml
generated:
by: apis.io/add
model: claude-opus-4-8
confidence: 88
at: '2026-08-09T13:12:11.291Z'
x-evidence:
verified: '2026-08-11'
request: https://github.com/api-search/inbox/issues/5
note: Every claim in the provider's request was fetched and verified. The OpenAPI we hold in openapi/_original/ is BYTE-IDENTICAL
to the live document (same MD5), and the refined per-tag split has 14/14 path overlap — harvested, not reconstructed.
fetched:
- url: https://bykaranteli.com/openapi.json
status: 200
note: openapi 3.1.0, 14 paths / 14 ops, byte-identical to openapi/_original/
- url: https://mcp.bykaranteli.com
status: 200
note: 'POST initialize + tools/list: 20 tools, unauthenticated, serverInfo v0.7.3'
- url: https://bykaranteli.com/llms.txt
status: 200
note: re-harvested 2026-08-11, 9118B (was 5694B at first harvest)
- url: https://bykaranteli.com/api/v1/public/manifest
status: 200
note: 10 free endpoints, endpoint set identical to the held copy
- url: https://bykaranteli.com/api/x402
status: 200
note: 13 priced endpoints, $0.002-$0.010, Solana + Base
- url: https://bykaranteli.com/api/x402/funding-history
status: 402
note: priced endpoint genuinely gates — a real x402 paywall, not a claim
- url: https://bykaranteli.com/api/public/indices
status: 200
note: unauthenticated, access-control-allow-origin *
- url: https://registry.npmjs.org/bykaranteli-mcp
status: 200
note: latest 0.7.3, MIT, matches the running server
- url: https://github.com/bykarantelicom/crypto-datasets
status: 200
note: SPDX CC0-1.0 — the CC0 claim is real
- url: https://bykaranteli.com/.well-known/apis.json
status: 404
note: genuine 404 (Next.js not-found), NOT a soft-404. Provider self-reported this.
- url: https://bykaranteli.com/.well-known/api-onboarding
status: 404
note: genuine 404. Provider self-reported it and declined credit for it.
root_cause: The MCPServer registration was NOT missing from the original profile. Commit d00650f registered it, along with
an Overlay pointer. refine-openapis rewrote apis.yml on 2026-08-09 at 20:31 — renaming the API, adding the aid, repointing
OpenAPI at the refined per-tag split — and dropped both `MCPServer` and `Overlay` from properties[] in the process, orphaning
overlays/bykaranteli-x402-overlay.yaml on disk. Both are restored here, and MCPServer is promoted to common[] where the
scorer actually reads it. See the roadmap issue on refine-openapis property loss.
not_credited: APICatalog stays on the API `properties[]` and is deliberately NOT promoted to `common[]`. The agent-readiness
`well_known_catalog` dimension reads APICatalog from `common[]` and is defined as an RFC 9727 /.well-known/api-catalog
linkset. ByKaranteli publishes a self-describing manifest at its own path, which is not that, and /.well-known/api-catalog
returns a verified 404. Promoting it would manufacture credit the provider has not earned. well_known_catalog correctly
stays false.
x-x402:
verified: true
probed: '2026-09-24'
url: https://bykaranteli.com/api/x402/flow-vpin
evidence:
- header:payment-required
control: 404
x-correction-request:
requested: '2026-10-02'
source:
- https://github.com/api-evangelist/bykaranteli/issues/2
request: 'Issue #2 (bykarantelicom, operator of bykaranteli.com), verified live 2026-10-02. (1) SIGNAL PRODUCT RETIRED:
/signals now 308-redirects to /data and /leaderboard to /symbols; llms.txt describes a data platform and calls PsiCharge
''not a trade signal''. Remove ''deterministic crypto-futures signal engine'', ''live signal performance'', ''win rate'',
''TP/SL'' and ''per-symbol/strategy leaderboards'' from description, PROFILE.md and API descriptions (note: /api/public/liquidation-leaderboard
is a liquidation-data endpoint, not a signal leaderboard - keep it). (2) NOT KEYLESS: unauthenticated GET /api/public/oi
and /api/public/liqmap return 401 code key_required; https://bykaranteli.com/openapi.json (OpenAPI 3.1.0, 105 paths) declares
securityScheme accountKey (http bearer, ''bk_...'' key, free with a verified account at /dashboard/api) and states 30
requests a minute on the free plan. Remove ''no-key'', ''free, no-key'', ''20 req/min/IP''. Exception to record accurately:
the Proof API (/api/v1/proof/*, e.g. /genesis) and /api/v1/public/manifest still answer 200 without a key. Docs: https://bykaranteli.com/developers;
api-catalog /.well-known/api-catalog (linkset) is live. (3) MCP: https://mcp.bykaranteli.com answers initialize (serverInfo
bykaranteli 0.31.0) and tools/list returns 67 tools; tool calls without a key return a key-required message. Take the
LIVE count (67, npm bykaranteli-mcp 0.31.0), NOT the 51 / 0.30.6 in the issue, and do NOT describe all tools as read-only
- the npm description says the alert and watchlist tools act on the account. (4) x402 catalog https://bykaranteli.com/api/x402
is live (networks Base eip155:8453 and Solana); use it as the authoritative priced list. (5) LICENCE: site data after
2026-09-10 is under the ByKaranteli Data Licence (https://bykaranteli.com/data#license; llms.txt: personal and research
use with attribution, commercial use on the Business plan); older datasets stay CC0 on their mirrors. Do not take: /apis.json
and /.well-known/apis.json return 404, so do not record an APIs.json for this provider. GitHub repo description is derived
from apis.yml and must follow the corrected description.'
x-enrichment:
date: '2026-10-02'
status: enriched
artifacts_added: 11
pass: modular-v1
engine: identity=local,contract=local,surfaces=local,docs=local,regulatory=local
ByKaranteli API — frequently asked questions
Does ByKaranteli have an API?
Yes. APIs.io lists 5 APIs from ByKaranteli, including ByKaranteli X402 API, ByKaranteli Public API and ByKaranteli Public API, and 2 more.
Is there an OpenAPI specification for the ByKaranteli API?
Yes. APIs.io indexes 5 OpenAPI specifications for ByKaranteli, each linked for download from this page.
How do I authenticate with the ByKaranteli API?
ByKaranteli uses bearer-token authentication (4 schemes). The details are profiled on APIs.io as Bykaranteli Authentication.
How much does the ByKaranteli API cost?
ByKaranteli publishes its prices; its Free account plan is $0 as of 2026-10-28. APIs.io lists 17 pricing plans for ByKaranteli, with each plan's price, limits and inclusions under Pricing on this page.
Does ByKaranteli have an MCP server?
Yes. APIs.io lists 1 MCP server for ByKaranteli: Remote MCP server at mcp.bykaranteli.com over HTTP; 20 tools listed.
Is the ByKaranteli API ready for AI agents?
ByKaranteli has a Kin Score of 59.4 out of 100 (strong) and an Agent Readiness score of 42.2 (agent-ready), scored by API Evangelist on 2026-11-06.
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API 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. See our Privacy Policy and
Terms.
Kin Score
How this is scored →
It updates itself when the score changes. Paste this where you link to your API docs: