DYOR API

https://docs.dyor.io/
Admin
DYOR API provides comprehensive TON analytics data, enabling users to track tokens, wallets, and...
Tokens:190,713
Snippets:270
Trust Score:8.8
Update:1 year ago
Show doc for...
Tokens:
Raw
### 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": "<string>"
}
```

--------------------------------

### 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
<p>
  Данные предоставлены 
  <a href="https://dyor.io/tonapi" target="_blank" style="display: inline-flex;">
    DYOR.io <img src="https://dyor.io/img/logos/dyorLogo.svg" alt="DYOR.io logo" width="16" height="16" style="margin-left: 4px;" />
  </a>
</p>
```

--------------------------------

### 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: <string>
                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: <string>
                chartPreviews:
                  - url: <string>
                    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
<p>
  Data provided by 
  <a href="https://dyor.io/tonapi" target="_blank" style="display: inline-flex;">
    DYOR.io <img src="https://dyor.io/img/logos/dyorLogo.svg" alt="DYOR.io logo" width="16" height="16" style="margin-left: 4px;" />
  </a>
</p>
```

--------------------------------

### 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: <string>
              next: <string>
        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: <string>
              excludeScam: true
              search: <string>
              address:
                - <string>
              admin:
                - <string>
              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: <string>
                    decimals: 123
                  max:
                    value: <string>
                    decimals: 123
              fdmc:
                min:
                  value: <string>
                  decimals: 123
                max:
                  value: <string>
                  decimals: 123
              trustScore:
                min: <string>
                max: <string>
              holders:
                min: <string>
                max: <string>
              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: <string>
        '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: <string>
                  details:
                    - '@type': <string>
      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
<p>
  Data provided by
  <a href="https://dyor.io/tonapi" target="_blank" style="display: inline-flex;">
    DYOR.io <img src="https://dyor.io/img/logos/dyorLogo.svg" alt="DYOR.io logo" width="16" height="16" style="margin-left: 4px;" />
  </a>
</p>
```

**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: <string>
      details:
        - '@type': <string>
```

--------------------------------

### 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": "<string>"
      }
    ],
    "next": "<string>"
  }
}
```

#### 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.
```
Tokens:
Raw