### Example API Response for Jetton Statistics Source: https://docs.dyor.io/ru/rest-api/jettonsservice/getjettonstatisticslist An example JSON response for a request to retrieve jetton statistics. This example demonstrates the structure for item data, including address and price change details across various timeframes (15 minutes, 1 hour, 6 hours, 12 hours, day, week). ```json { "items": [ { "address": "0:906697a57af1cdb1bc39214b7049ae02b3c92a5b0c342ac61e0eb8bd9304b5f1", "priceChange": { "ton": { "min15": { "changePercent": 146.1, "previous": { "value": "1000500000", "decimals": 9 }, "current": { "value": "1000500000", "decimals": 9 }, "calculatedAt": "2023-11-07T05:31:56Z" }, "hour": { "changePercent": 146.1, "previous": { "value": "1000500000", "decimals": 9 }, "current": { "value": "1000500000", "decimals": 9 }, "calculatedAt": "2023-11-07T05:31:56Z" }, "hour6": { "changePercent": 146.1, "previous": { "value": "1000500000", "decimals": 9 }, "current": { "value": "1000500000", "decimals": 9 }, "calculatedAt": "2023-11-07T05:31:56Z" }, "hour12": { "changePercent": 146.1, "previous": { "value": "1000500000", "decimals": 9 }, "current": { "value": "1000500000", "decimals": 9 }, "calculatedAt": "2023-11-07T05:31:56Z" }, "day": { "changePercent": 146.1, "previous": { "value": "1000500000", "decimals": 9 }, "current": { "value": "1000500000", "decimals": 9 }, "calculatedAt": "2023-11-07T05:31:56Z" }, "week": { "changePercent": 146.1, "previous": { "value": "1000500000", "decimals": 9 }, "current": { "value": "1000500000", "decimals": 9 }, "calculatedAt": "2023-11-07T05:31:56Z" } } } } ] } ``` -------------------------------- ### Example v1JettonsGetStatsListResponse JSON Source: https://docs.dyor.io/rest-api/jettonsservice/getjettonstatisticslist Provides an example JSON payload for the v1JettonsGetStatsListResponse. This includes sample data for jetton statistics, showcasing price changes over different time intervals (15 minutes, hour, 6 hours, 12 hours, day, week). ```json { "items": [ { "address": ">- 0:906697a57af1cdb1bc39214b7049ae02b3c92a5b0c342ac61e0eb8bd9304b5f1", "priceChange": { "ton": { "min15": { "changePercent": 146.1, "previous": { "value": "1000500000", "decimals": 9 }, "current": { "value": "1000500000", "decimals": 9 }, "calculatedAt": "2023-11-07T05:31:56Z" }, "hour": { "changePercent": 146.1, "previous": { "value": "1000500000", "decimals": 9 }, "current": { "value": "1000500000", "decimals": 9 }, "calculatedAt": "2023-11-07T05:31:56Z" }, "hour6": { "changePercent": 146.1, "previous": { "value": "1000500000", "decimals": 9 }, "current": { "value": "1000500000", "decimals": 9 }, "calculatedAt": "2023-11-07T05:31:56Z" }, "hour12": { "changePercent": 146.1, "previous": { "value": "1000500000", "decimals": 9 }, "current": { "value": "1000500000", "decimals": 9 }, "calculatedAt": "2023-11-07T05:31:56Z" }, "day": { "changePercent": 146.1, "previous": { "value": "1000500000", "decimals": 9 }, "current": { "value": "1000500000", "decimals": 9 }, "calculatedAt": "2023-11-07T05:31:56Z" }, "week": { "changePercent": 146.1, "previous": { "value": "1000500000", "decimals": 9 }, "current": { "value": "1000500000", "decimals": 9 }, "calculatedAt": "2023-11-07T05:31:56Z" } } } } ] } ``` -------------------------------- ### Example API Response (200 OK) for Jetton Trust Score List Source: https://docs.dyor.io/rest-api/jettonsservice/getjettontrustscorelist This example demonstrates a successful response (HTTP 200) for the jetton trust score list API. It includes a list of trust scores, an address book, jetton metadata, and a cursor for pagination. ```json { "items": [ { "address": "0:906697a57af1cdb1bc39214b7049ae02b3c92a5b0c342ac61e0eb8bd9304b5f1", "score": 78, "updatedAt": "2023-11-07T05:31:56Z" } ], "addressBook": {}, "jettons": {}, "next": "" } ``` -------------------------------- ### HTML Example: DYOR.io Source Attribution Link Source: https://docs.dyor.io/ru/technical-guides/client This HTML snippet demonstrates how to correctly include an active link to DYOR.io as required for using their API. It includes text, a hyperlink, and an image of the DYOR.io logo, ensuring compliance with the API usage terms. This method is crucial for maintaining access to the API. ```html

Данные предоставлены DYOR.io DYOR.io logo

``` -------------------------------- ### Get Jetton Details via OpenAPI Source: https://docs.dyor.io/rest-api/jettonsservice/getjettondetails This OpenAPI definition describes the GET request to retrieve detailed information about a Jetton token on the TON Blockchain. It specifies the endpoint '/v1/jettons/{address}', required path parameters, request/response schemas, and example responses for success and various error conditions (400, 404, 429). ```yaml paths: path: /v1/jettons/{address} method: get servers: - url: https://api.dyor.io/ request: security: [] parameters: path: address: schema: - type: string required: true description: |- Jetton address Example: `EQCQZpelevHNsbw5IUtwSa4Cs8kqWww0KsYeDri9kwS18eCz` query: {} header: {} cookie: {} body: {} response: '200': application/json: schemaArray: - type: object properties: details: allOf: - $ref: '#/components/schemas/v1JettonDetails' addressBook: allOf: - title: Possible aliases for all raw addresses in response type: object additionalProperties: $ref: '#/components/schemas/v1AddressBookItem' refIdentifier: '#/components/schemas/v1JettonsGetDetailsResponse' examples: example: value: details: metadata: address: >- 0:906697a57af1cdb1bc39214b7049ae02b3c92a5b0c342ac61e0eb8bd9304b5f1 name: DYOR Coin symbol: DYOR decimals: 15 image: >- https://storage.dyor.io/jettons/EQCQZpelevHNsbw5IUtwSa4Cs8kqWww0KsYeDri9kwS18eCz/image.png description: >- DYOR Coin is the utility token by DYOR.io, the biggest analytics platform on TON Blockchain. offchainImage: >- https://storage.dyor.io/jettons/EQCQZpelevHNsbw5IUtwSa4Cs8kqWww0KsYeDri9kwS18eCz/image.png offchainDescription: >- DYOR Coin is the utility token by DYOR.io, the biggest analytics platform on TON Blockchain. links: - name: Chat EN url: https://t.me/DYORchatEN type: LINK_TYPE_UNSPECIFIED createdAt: '2023-11-07T05:31:56Z' admin: address: '0:0000000000000000000000000000000000000000000000000000000000000000' offchainAddress: totalSupply: '299999852059244670506' mintable: true modifiedContract: true verification: JVS_NONE price: value: '1000500000' decimals: 9 priceUsd: value: '1000500000' decimals: 9 holdersCount: '7351' liquidityUsd: value: '1000500000' decimals: 9 fdmc: value: '1000500000' decimals: 9 trustScore: 100 mcap: value: '1000500000' decimals: 9 circulatingSupply: chartPreviews: - url: metric: price period: month color: dark addressBook: {} description: A successful response. '400': application/json: schemaArray: - type: object properties: code: allOf: - &ref_0 type: integer format: int32 message: allOf: - &ref_1 type: string details: allOf: - &ref_2 type: array items: $ref: '#/components/schemas/protobufAny' refIdentifier: '#/components/schemas/rpcStatus' examples: example: value: code: 3 message: invalid value details: [] description: Returned when the request parameters have an invalid value '404': application/json: schemaArray: - type: object properties: code: allOf: - *ref_0 message: allOf: - *ref_1 details: allOf: - *ref_2 refIdentifier: '#/components/schemas/rpcStatus' examples: example: value: code: 5 message: not found details: [] description: Returned when the resource does not exist '429': application/json: schemaArray: - type: object properties: code: ``` -------------------------------- ### Get Token Price History using cURL Source: https://context7.com/context7/dyor_io/llms.txt Fetches historical price data points for a token, supporting pagination. This endpoint is useful for creating charts and performing detailed analysis. Parameters include limit, start time, and end time. ```bash curl -X GET "https://api.dyor.io/v1/jettons/EQCQZpelevHNsbw5IUtwSa4Cs8kqWww0KsYeDri9kwS18eCz/price/ticks?limit=100&from=2024-01-01T00:00:00Z&to=2024-01-31T23:59:59Z" ``` -------------------------------- ### Example Client-Side Source Attribution (HTML) Source: https://docs.dyor.io/technical-guides/client This HTML snippet demonstrates the required source attribution for using DYOR.io data on your website. It includes an active link to DYOR.io and their logo, which is crucial for maintaining API access. ```html

Data provided by DYOR.io DYOR.io logo

``` -------------------------------- ### Get Jetton Liquidity Ticks - OpenAPI Specification Source: https://docs.dyor.io/rest-api/jettonsservice/getjettonmarketliquidityhistory This OpenAPI specification defines the endpoint for retrieving liquidity ticks for a given Jetton address and market pool. It includes details on request parameters (path, query, headers), response schemas for success and error cases, and example responses. Dependencies include the base API URL and specific schema definitions. ```yaml paths: path: /v1/jettons/{address}/markets/{poolAddress}/liquidity/ticks method: get servers: - url: https://api.dyor.io/ request: security: [] parameters: path: address: schema: - type: string required: true description: |- Jetton address Example: `EQCQZpelevHNsbw5IUtwSa4Cs8kqWww0KsYeDri9kwS18eCz` poolAddress: schema: - type: string required: true description: |- Market liquidity pool address Example: `EQBYsz1HIQdap8acCZZJsNlySx4riy9IqfNC66a8NWU5igPZ` query: limit: schema: - type: integer description: |- Default value: 20 Max value: 1000 cursor: schema: - type: string description: |- Cursor to paginate list Should be set by value from response field `next` from: schema: - type: string format: date-time to: schema: - type: string format: date-time header: {} cookie: {} body: {} response: '200': application/json: schemaArray: - type: object properties: items: allOf: - type: array items: $ref: '#/components/schemas/v1JettonMarketLiquidityTick' next: allOf: - title: Cursor to next page type: string description: If the field is empty or not exists there's no next page examples: example: value: items: - value: asset: value: '1000500000' decimals: 9 counterpart: value: '1000500000' decimals: 9 time: '2023-11-07T05:31:56Z' timeLt: next: description: A successful response. '400': application/json: schemaArray: - type: object properties: code: allOf: - type: integer format: int32 message: allOf: - type: string details: allOf: - type: array items: $ref: '#/components/schemas/protobufAny' refIdentifier: '#/components/schemas/rpcStatus' examples: example: value: code: 3 message: invalid value details: [] description: Returned when the request parameters have an invalid value '404': application/json: schemaArray: - type: object properties: code: allOf: - type: integer format: int32 message: allOf: - type: string details: allOf: - type: array items: $ref: '#/components/schemas/protobufAny' refIdentifier: '#/components/schemas/rpcStatus' examples: example: value: code: 5 message: not found details: [] description: Returned when the resource does not exist '429': application/json: schemaArray: - type: object properties: code: allOf: - type: integer format: int32 message: allOf: - type: string details: allOf: - type: array items: $ref: '#/components/schemas/protobufAny' refIdentifier: '#/components/schemas/rpcStatus' examples: example: value: code: 8 message: too many requests details: [] description: Returned when the limit of requests per second is exceeded default: application/json: schemaArray: - type: object properties: code: allOf: - type: integer format: int32 message: allOf: - type: string details: allOf: - type: array items: $ref: '#/components/schemas/protobufAny' refIdentifier: '#/components/schemas/rpcStatus' examples: example: value: code: 123 ``` -------------------------------- ### Client-Side Usage - JavaScript Source: https://context7.com/context7/dyor_io/llms.txt Provides an example of making unauthenticated client-side requests to public API endpoints. Includes basic fetch implementation and error handling. Adherence to rate limits and attribution requirements is mandatory for client-side usage. ```javascript // Client-side example (no API key needed) fetch('https://api.dyor.io/v1/jettons/EQCQZpelevHNsbw5IUtwSa4Cs8kqWww0KsYeDri9kwS18eCz') .then(res => res.json()) .then(data => console.log(data.details)) .catch(err => console.error(err)); ``` -------------------------------- ### POST /v1/jettons/metrics Request Example Source: https://docs.dyor.io/ru/rest-api/jettonsservice/getjettonmetricslist-1 Example request body for the POST /v1/jettons/metrics endpoint. This endpoint allows fetching jetton metrics with various filtering and sorting options. It supports filtering by limit, cursor, scam exclusion, search query, addresses, admin addresses, verification status, sort order, price change, liquidity, FDMC, trust score, holders, and currency. ```yaml paths: path: /v1/jettons/metrics method: post servers: - url: https://api.dyor.io/ request: security: [] parameters: path: {} query: {} header: {} cookie: {} body: application/json: schemaArray: - type: object properties: limit: allOf: - title: 'Default value: 20' type: integer description: 'Max value: 100' format: int64 cursor: allOf: - title: Cursor to paginate list type: string description: Should be set by value from response field `next` excludeScam: allOf: - title: Flag to exclude scam jettons type: boolean description: >- Jettons marked as scam will be excluded, if it's set to `true` search: allOf: - title: Search by phrase type: string description: |- Search by phrase in jetton name or symbol Length should be in range [3:255] address: allOf: - title: Jetton address type: array description: >- Example: `EQCQZpelevHNsbw5IUtwSa4Cs8kqWww0KsYeDri9kwS18eCz` Max count: 100 items: type: string admin: allOf: - title: Wallet address type: array description: >- Example: `EQCQZpelevHNsbw5IUtwSa4Cs8kqWww0KsYeDri9kwS18eCz` Max count: 10 items: type: string verification: allOf: - title: Status of jetton verification type: array description: 'Max count: 5' items: $ref: '#/components/schemas/v1JettonVerificationStatus' sort: allOf: - $ref: '#/components/schemas/JettonsListRequestSortValue' order: allOf: - $ref: '#/components/schemas/v1SortOrder' priceChange: allOf: - $ref: '#/components/schemas/JettonsListRequestPriceChangeFilter' liquidity: allOf: - $ref: '#/components/schemas/JettonsListRequestLiquidityFilter' fdmc: allOf: - $ref: '#/components/schemas/v1FilterDecimalRange' trustScore: allOf: - $ref: '#/components/schemas/v1FilterIntRange' holders: allOf: - $ref: '#/components/schemas/v1FilterIntRange' currency: allOf: - $ref: '#/components/schemas/v1Currency' required: true refIdentifier: '#/components/schemas/v1JettonsListRequest' examples: example: value: limit: 123 cursor: excludeScam: true search: address: - admin: - verification: - JVS_NONE sort: createdAt order: asc priceChange: ton: hour: min: 123 max: 123 hour6: min: 123 max: 123 day: min: 123 max: 123 week: min: 123 max: 123 liquidity: usd: min: value: decimals: 123 max: value: decimals: 123 fdmc: min: value: decimals: 123 max: value: decimals: 123 trustScore: min: max: holders: min: max: currency: ton response: '200': application/json: schemaArray: - type: object properties: items: ``` -------------------------------- ### RPC Status Schema Example Source: https://docs.dyor.io/ru/rest-api/jettonsservice/getjettonliquidity This example demonstrates the structure of an RPC status response, typically used to indicate success or error codes and messages. It includes a specific example for exceeding request limits. ```yaml default: application/json: schemaArray: - type: object properties: code: allOf: - *ref_0 message: allOf: - *ref_1 details: allOf: - *ref_2 refIdentifier: '#/components/schemas/rpcStatus' examples: example: value: code: 8 message: too many requests details: [] ``` -------------------------------- ### OpenAPI Specification for Jetton Price Ticks Source: https://docs.dyor.io/rest-api/jettonsservice/getjettonpricehistory This YAML defines the OpenAPI specification for the /v1/jettons/{address}/price/ticks endpoint. It includes details on request parameters (path, query, header), response schemas for success (200) and error codes (400, 404, 429, default), and example responses. The endpoint allows fetching historical price data for a specified jetton address. ```yaml paths: /v1/jettons/{address}/price/ticks: get: servers: - url: https://api.dyor.io/ request: parameters: path: address: schema: type: string required: true description: 'Jetton address' query: limit: schema: type: integer description: 'Default value: 20, Max value: 1000' cursor: schema: type: string description: 'Cursor to paginate list' from: schema: type: string format: date-time to: schema: type: string format: date-time security: [] body: {} response: '200': application/json: schema: type: object properties: items: type: array items: $ref: '#/components/schemas/v1JettonPriceHistoryItem' next: type: string description: 'Cursor to next page' examples: example: value: items: - value: ton: value: '1000500000' decimals: 9 usd: value: '1000500000' decimals: 9 time: '2023-11-07T05:31:56Z' next: '400': application/json: schema: $ref: '#/components/schemas/rpcStatus' examples: example: value: code: 3 message: invalid value details: [] '404': application/json: schema: $ref: '#/components/schemas/rpcStatus' examples: example: value: code: 5 message: not found details: [] '429': application/json: schema: $ref: '#/components/schemas/rpcStatus' examples: example: value: code: 8 message: too many requests details: [] default: application/json: schema: $ref: '#/components/schemas/rpcStatus' examples: example: value: code: 123 message: details: - '@type': deprecated: false type: path components: schemas: v1JettonPriceHistoryItem: type: object properties: value: type: object properties: ton: type: object properties: value: type: string decimals: type: integer usd: type: object properties: value: type: string decimals: type: integer time: type: string format: date-time timeLt: type: string rpcStatus: type: object properties: code: type: integer format: int32 message: type: string details: type: array items: $ref: '#/components/schemas/protobufAny' protobufAny: type: object properties: '@type': type: string additionalProperties: {} ``` -------------------------------- ### Authentication Source: https://context7.com/context7/dyor_io/llms.txt Details on how to authenticate requests, including server-side API key usage and client-side requirements. ```APIDOC ## Authentication ### Server-Side Authentication For authenticated requests with increased rate limits, include your API key in the `Authorization` header as a Bearer token. #### Request Example ```bash curl -X GET "https://api.dyor.io/v1/jettons" \ -H "Authorization: Bearer YOUR_API_KEY_HERE" ``` Obtain your API key from [https://dyor.io/tonapi?pricing](https://dyor.io/tonapi?pricing). **Security Recommendation:** Avoid exposing API keys in client-side code. Utilize a server-side proxy for production applications. ### Client-Side Usage Public endpoints can be accessed directly from the client-side without authentication. However, specific requirements must be met: #### Requirements 1. **Rate Limit:** Adhere to a rate limit of 1 request per second. 2. **Attribution:** Display "Data provided by DYOR.io" with an active link and logo. #### Attribution HTML ```html

Data provided by DYOR.io DYOR.io logo

``` **Warning:** Failure to comply with attribution requirements may lead to access revocation. #### Client-Side Request Example ```javascript // Client-side example (no API key needed) fetch('https://api.dyor.io/v1/jettons/EQCQZpelevHNsbw5IUtwSa4Cs8kqWww0KsYeDri9kwS18eCz') .then(res => res.json()) .then(data => console.log(data.details)) .catch(err => console.error(err)); ``` ``` -------------------------------- ### Server-Side Authentication - Bash Source: https://context7.com/context7/dyor_io/llms.txt Demonstrates how to authenticate server-side requests using an API key included in the Authorization header. This method provides higher rate limits. It is crucial to keep API keys secure and not expose them in client-side code. ```bash curl -X GET "https://api.dyor.io/v1/jettons" \ -H "Authorization: Bearer YOUR_API_KEY_HERE" ``` -------------------------------- ### RPC Error Example: Unexpected Error Source: https://docs.dyor.io/rest-api/jettonsservice/getjettonpricechart An example of a general unexpected error response. It includes a placeholder for a string message and details that conform to the protobufAny schema. ```yaml examples: example: value: code: 123 message: details: - '@type': ``` -------------------------------- ### RPC Error Example: Too Many Requests Source: https://docs.dyor.io/rest-api/jettonsservice/getjettonpricechart An example of an RPC response when the limit of requests per second is exceeded. It includes a specific error code and message. ```yaml examples: example: value: code: 8 message: too many requests details: [] ``` -------------------------------- ### GET /v1/jettons Source: https://docs.dyor.io/rest-api/jettonsservice/getjettons-1 Retrieves a list of jettons with their details. Supports pagination using a cursor. ```APIDOC ## GET /v1/jettons ### Description Retrieves a list of jettons with their metadata, admin addresses, supply information, price, and trust scores. The response includes a cursor for paginating through the list. ### Method GET ### Endpoint /v1/jettons ### Parameters #### Query Parameters - **limit** (integer) - Optional - The maximum number of jettons to return per page. - **offset** (string) - Optional - The cursor for the next page of results. ### Request Example ```json { "limit": 10, "offset": "some_cursor_string" } ``` ### Response #### Success Response (200) - **jettons** (array) - An array of jetton objects. - **metadata** (object) - Metadata for the jetton. - **address** (string) - The unique address of the jetton. - **name** (string) - The name of the jetton. - **symbol** (string) - The symbol of the jetton. - **decimals** (integer) - The number of decimals for the jetton. - **image** (string) - URL of the jetton's image. - **description** (string) - Description of the jetton. - **offchainImage** (string) - Off-chain URL of the jetton's image. - **offchainDescription** (string) - Off-chain description of the jetton. - **links** (array) - Array of links associated with the jetton. - **name** (string) - Name of the link. - **url** (string) - URL of the link. - **type** (string) - Type of the link. - **createdAt** (string) - Timestamp when the jetton was created. - **admin** (object) - Admin information for the jetton. - **address** (string) - The admin's address. - **offchainAddress** (string) - The admin's off-chain address. - **totalSupply** (string) - The total supply of the jetton. - **mintable** (boolean) - Indicates if the jetton is mintable. - **modifiedContract** (boolean) - Indicates if the jetton contract has been modified. - **verification** (string) - Verification status of the jetton. - **price** (object) - Current price of the jetton. - **value** (string) - The price value. - **decimals** (integer) - The decimals for the price value. - **priceUsd** (object) - Current price of the jetton in USD. - **value** (string) - The price value in USD. - **decimals** (integer) - The decimals for the USD price value. - **holdersCount** (string) - The number of holders for the jetton. - **liquidityUsd** (object) - The liquidity of the jetton in USD. - **value** (string) - The liquidity value in USD. - **decimals** (integer) - The decimals for the USD liquidity value. - **fdmc** (object) - Fully diluted market cap. - **value** (string) - The FDMC value. - **decimals** (integer) - The decimals for the FDMC value. - **trustScore** (integer) - The trust score of the jetton. - **mcap** (object) - Market cap of the jetton. - **value** (string) - The market cap value. - **decimals** (integer) - The decimals for the market cap value. - **circulatingSupply** (string) - The circulating supply of the jetton. - **chartPreviews** (array) - Array of chart preview URLs. - **url** (string) - URL of the chart preview. - **metric** (string) - Metric type (e.g., price). - **period** (string) - Time period for the chart. - **color** (string) - Color scheme for the chart. - **addressBook** (object) - An object containing possible aliases for raw addresses. - **next** (string) - A cursor to the next page of results. If empty or absent, there are no more pages. #### Response Example ```json { "jettons": [ { "metadata": { "address": "0:906697a57af1cdb1bc39214b7049ae02b3c92a5b0c342ac61e0eb8bd9304b5f1", "name": "DYOR Coin", "symbol": "DYOR", "decimals": 15, "image": "https://storage.dyor.io/jettons/EQCQZpelevHNsbw5IUtwSa4Cs8kqWww0KsYeDri9kwS18eCz/image.png", "description": "DYOR Coin is the utility token by DYOR.io, the biggest analytics platform on TON Blockchain.", "offchainImage": "https://storage.dyor.io/jettons/EQCQZpelevHNsbw5IUtwSa4Cs8kqWww0KsYeDri9kwS18eCz/image.png", "offchainDescription": "DYOR Coin is the utility token by DYOR.io, the biggest analytics platform on TON Blockchain.", "links": [ { "name": "Chat EN", "url": "https://t.me/DYORchatEN", "type": "LINK_TYPE_UNSPECIFIED" } ], "createdAt": "2023-11-07T05:31:56Z" }, "admin": { "address": "0:0000000000000000000000000000000000000000000000000000000000000000", "offchainAddress": null }, "totalSupply": "299999852059244670506", "mintable": true, "modifiedContract": true, "verification": "JVS_NONE", "price": { "value": "1000500000", "decimals": 9 }, "priceUsd": { "value": "1000500000", "decimals": 9 }, "holdersCount": "7351", "liquidityUsd": { "value": "1000500000", "decimals": 9 }, "fdmc": { "value": "1000500000", "decimals": 9 }, "trustScore": 100, "mcap": { "value": "1000500000", "decimals": 9 }, "circulatingSupply": null, "chartPreviews": [ { "url": null, "metric": "price", "period": "month", "color": "dark" } ] } ], "addressBook": {}, "next": null } ``` #### Error Response (400) Returned when the request parameters have an invalid value. - **code** (integer) - The error code. - **message** (string) - A message describing the error. - **details** (array) - An array of additional error details. #### Error Response (404) Returned when the resource does not exist. - **code** (integer) - The error code. - **message** (string) - A message describing the error. - **details** (array) - An array of additional error details. #### Error Response (429) Returned when the client has sent too many requests in a given amount of time. - **code** (integer) - The error code. - **message** (string) - A message describing the error. - **details** (array) - An array of additional error details. ``` -------------------------------- ### Example API Response (404 Not Found) for Jetton Trust Score Source: https://docs.dyor.io/rest-api/jettonsservice/getjettontrustscorelist This example illustrates an API response when the requested resource cannot be found. It returns a specific error code, a 'not found' message, and an empty details array. ```json { "code": 5, "message": "not found", "details": [] } ``` -------------------------------- ### GET /v1/jettons/{address}/price/ticks Source: https://docs.dyor.io/rest-api/jettonsservice/getjettonpricehistory Retrieves historical price ticks for a specified Jetton token address. Supports pagination, date range filtering, and rate limiting. ```APIDOC ## GET /v1/jettons/{address}/price/ticks ### Description Retrieves historical price ticks for a specified Jetton token address. Supports pagination, date range filtering, and rate limiting. ### Method GET ### Endpoint `/v1/jettons/{address}/price/ticks` ### Parameters #### Path Parameters - **address** (string) - Required - Jetton address #### Query Parameters - **limit** (integer) - Optional - Default value: 20. Max value: 1000. - **cursor** (string) - Optional - Cursor to paginate list. Should be set by value from response field `next`. - **from** (string) - Optional - Format: date-time. Filters results from this timestamp. - **to** (string) - Optional - Format: date-time. Filters results up to this timestamp. #### Request Body This endpoint does not accept a request body. ### Request Example ```json { "example": "No request body needed for this endpoint." } ``` ### Response #### Success Response (200) - **items** (array) - Array of price tick objects. - **value** (object) - Price information. - **ton** (object) - TON value. - **value** (string) - The price value in TON. - **decimals** (integer) - The number of decimal places for the TON price. - **usd** (object) - USD value. - **value** (string) - The price value in USD. - **decimals** (integer) - The number of decimal places for the USD price. - **time** (string) - Timestamp of the price tick (ISO 8601 format). - **timeLt** (string) - Timestamp less than (used for pagination). - **next** (string) - Cursor to the next page of results. Empty or absent if no next page. #### Response Example ```json { "example": { "items": [ { "value": { "ton": { "value": "1000500000", "decimals": 9 }, "usd": { "value": "1000500000", "decimals": 9 } }, "time": "2023-11-07T05:31:56Z", "timeLt": "" } ], "next": "" } } ``` #### Error Response (400) Returned when the request parameters have an invalid value. - **code** (integer) - Error code. - **message** (string) - Error message. - **details** (array) - Array of error details. #### Error Response (404) Returned when the resource does not exist. - **code** (integer) - Error code. - **message** (string) - Error message. - **details** (array) - Array of error details. #### Error Response (429) Returned when the limit of requests per second is exceeded. - **code** (integer) - Error code. - **message** (string) - Error message. - **details** (array) - Array of error details. #### Error Response (default) An unexpected error response. - **code** (integer) - Error code. - **message** (string) - Error message. - **details** (array) - Array of error details. ```