Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

TOP Group (The Open Platform) Rates API

The Rates API from TOP Group (The Open Platform) — 3 operation(s) for rates.

TOP Group (The Open Platform) Rates API is one of 23 APIs that TOP Group (The Open Platform) publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Rates. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 3 operations across 3 paths, and defines 4 schemas. It is described by OpenAPI 3.0.0, at version 2.0.0.

Requests are made against 3 base URLs: https://tonapi.io, https://testnet.tonapi.io, http://localhost:8081.

3 operations 3 paths 4 schemas 3 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
2.0.0
Base URL
https://tonapi.io
Contact
Resource Areas
1

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 3 GET. Each is listed below with its method, path, parameters, and response codes.

Rates 3
GET
/v2/rates
Get the token price in the chosen currency for display only. Don’t use this for financial transactions.
getRates 2 params → 200default
GET
/v2/rates/chart
Get chart by token
getChartRates 5 params → 200default
GET
/v2/rates/markets
Get the Gram price from markets
getMarketsRates → 200default

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are TokenRates (4 properties), MarketTonRates (3 properties), InsufficientFunds (2 properties). Each schema is shown below with its type and property counts.

MarketTonRates
object
3 properties 3 required
ChartPoints
array
Each inner array is a pair [timestamp, price]: • index 0 — Unix timestamp (int64) • index 1 — token price (decimal) in the requested currency.
InsufficientFunds
object
Present on an error when a request failed because the source wallet does not hold enough TON to cover the required gas (errorcode 50000).
2 properties 2 required
TokenRates
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

top-group-rates-api-openapi.yml Raw ↑

Other APIs TOP Group (The Open Platform) publishes across the network.

TOP Group (The Open Platform) Accounts API
TOP Group (The Open Platform) Blockchain API
TOP Group (The Open Platform) Connect API
TOP Group (The Open Platform) DNS API
TOP Group (The Open Platform) Emulation API
TOP Group (The Open Platform) Events API
TOP Group (The Open Platform) ExtraCurrency API
TOP Group (The Open Platform) Gasless API
TOP Group (The Open Platform) Jettons API
TOP Group (The Open Platform) Lite Server API
TOP Group (The Open Platform) Migration API
TOP Group (The Open Platform) Multisig API