Amberdata Analytics API

openapi: 3.2.0
info:
  title: Amberdata Analytics API
  version: '2'
  description: 'Operations tagged Analytics across 2 of this provider''s published API definitions: amberdata-blockchain-openapi.yaml, amberdata-derivatives-openapi.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.amberdata.com/blockchains
- url: https://api.amberdata.com/markets/derivatives
security:
- sec0: []
tags:
- name: Analytics
paths:
  /analytics/stablecoins/information:
    get:
      summary: Stablecoins Supported Assets & Insights
      description: Retrieve the collection of supported stablecoins and insights.
      operationId: stablecoins-information-gold
      parameters:
      - name: assetSymbol
        in: query
        description: '[**optional**] The symbol of the asset to filter the dataset by'
        schema:
          type: string
        required: false
      - name: blockchain
        in: query
        description: '[**optional**] The name slug of the chain to filter the dataset by'
        schema:
          type: string
          enum:
          - arbitrum-mainnet
          - avalanche-mainnet
          - base-mainnet
          - bnb-mainnet
          - ethereum-mainnet
          - polygon-mainnet
          - optimism-mainnet
          - tron-mainnet
        required: false
      responses:
        '200':
          description: Successful request
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    description: HTTP status code
                    example: 200
                  title:
                    type: string
                    description: Status title
                    example: OK
                  description:
                    type: string
                    description: Status description
                    example: Successful request
                  payload:
                    type: object
                    properties:
                      data:
                        type: array
                        items:
                          type: object
                          properties:
                            analytics:
                              type: array
                              items:
                                type: string
                              description: Available analytics for this asset
                              example:
                              - Transfers
                            assetAddresses:
                              type: array
                              items:
                                type: object
                                properties:
                                  address:
                                    type: string
                                    description: Asset contract address on the blockchain
                                    example: '0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9'
                                  blockchain:
                                    type: string
                                    description: Blockchain network identifier
                                    example: arbitrum-mainnet
                                  decimals:
                                    type: integer
                                    description: Number of decimal places for the asset
                                    example: 6
                                required:
                                - address
                                - blockchain
                                - decimals
                              description: List of asset addresses across different blockchains
                              example:
                              - address: '0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9'
                                blockchain: arbitrum-mainnet
                                decimals: 6
                              - address: '0x9702230a8ea53601f5cd2dc00fdbc13d4df4a8c7'
                                blockchain: avalanche-mainnet
                                decimals: 6
                              - address: '0x55d398326f99059ff775485246999027b3197955'
                                blockchain: bnb-mainnet
                                decimals: 18
                              - address: '0xdac17f958d2ee523a2206206994597c13d831ec7'
                                blockchain: ethereum-mainnet
                                decimals: 6
                              - address: '0x94b008aa00579c1307b0ef2c499ad98a8ce58e58'
                                blockchain: optimism-mainnet
                                decimals: 6
                              - address: '0xc2132d05d31c914a87c6611c10748aeb04b58e8f'
                                blockchain: polygon-mainnet
                                decimals: 6
                              - address: TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
                                blockchain: tron-mainnet
                                decimals: 6
                            assetName:
                              type: string
                              description: Full name of the asset
                              example: Tether USD
                            assetSymbol:
                              type: string
                              description: Symbol/ticker of the asset
                              example: USDT
                          required:
                          - analytics
                          - assetAddresses
                          - assetName
                          - assetSymbol
                        description: Array of asset information objects
                      metadata:
                        type: object
                        description: Additional metadata for the response
                        example: {}
                    required:
                    - data
                    - metadata
                required:
                - status
                - title
                - description
                - payload
      security:
      - ApiKeyAuth: []
      tags:
      - Analytics
    servers:
    - url: https://api.amberdata.com/blockchains
  /analytics/stablecoins/transfers:
    get:
      summary: Stablecoin Transfers - Aggregated Insights
      description: 'Analyze stablecoin adoption, liquidity flows and transaction values across multiple chains and multiple assets.

        The dataset is updated on an hourly cadence.'
      operationId: stablecoin-transfers-hourly-gold
      parameters:
      - name: assetSymbol
        in: query
        description: '[**optional**] The symbol of the asset to filter the dataset by'
        schema:
          type: string
        required: false
      - name: assetAddress
        in: query
        description: '[**optional**] The contract address of the asset to filter the dataset by'
        schema:
          type: string
        required: false
      - name: startDate
        in: query
        description: '[**optional**] The oldest date to filter the dataset by (inclusive)'
        schema:
          type: string
        required: false
      - name: endDate
        in: query
        description: '[**optional**] The latest data to filter the dataset by (exclusive)'
        schema:
          type: string
        required: false
      - name: blockchain
        in: query
        description: '[**optional**] The name slug of the chain to filter the dataset by'
        schema:
          type: string
          enum:
          - arbitrum-mainnet
          - avalanche-mainnet
          - base-mainnet
          - bnb-mainnet
          - ethereum-mainnet
          - polygon-mainnet
          - optimism-mainnet
          - tron-mainnet
        required: false
      responses:
        '200':
          description: Successful request
          content:
            application/json:
              schema:
                type: object
                required:
                - status
                - title
                - description
                - payload
                properties:
                  status:
                    type: integer
                    description: HTTP status code
                    example: 200
                  title:
                    type: string
                    description: Response status title
                    example: OK
                  description:
                    type: string
                    description: Response description
                    example: Successful request
                  payload:
                    type: object
                    required:
                    - data
                    - metadata
                    properties:
                      data:
                        type: array
                        description: Array of transfer analytics data points
                        items:
                          type: object
                          required:
                          - assetAddress
                          - assetName
                          - assetSymbol
                          - blockchain
                          - burnVolume
                          - mintVolume
                          - numberOfBurns
                          - numberOfMints
                          - numberOfTransfers
                          - numberOfUniqueReceivers
                          - numberOfUniqueSenders
                          - timestamp
                          - transferVolume
                          properties:
                            assetAddress:
                              type: string
                              description: The blockchain address of the asset
                              example: '0x94b008aa00579c1307b0ef2c499ad98a8ce58e58'
                            assetName:
                              type: string
                              description: The full name of the asset
                              example: Tether USD
                            assetSymbol:
                              type: string
                              description: The symbol/ticker of the asset
                              example: USDT
                            blockchain:
                              type: string
                              description: The blockchain network on which the asset contract is deployed on
                              enum:
                              - optimism-mainnet
                              - avalanche-mainnet
                              - tron-mainnet
                              - ethereum-mainnet
                              - arbitrum-mainnet
                              - polygon-mainnet
                              - base-mainnet
                              - bnb-mainnet
                              example: optimism-mainnet
                            burnVolume:
                              type: string
                              description: Total volume of tokens burned. Measured in USD.
                              example: '1038393.596801'
                            mintVolume:
                              type: string
                              description: Total volume of tokens minted. Measured in USD.
                              example: '328456.31803'
                            numberOfBurns:
                              type: string
                              description: Total number of burn transactions
                              example: '26'
                            numberOfMints:
                              type: string
                              description: Total number of mint transactions
                              example: '10'
                            numberOfTransfers:
                              type: string
                              description: Total number of transfer transactions
                              example: '4137'
                            numberOfUniqueReceivers:
                              type: string
                              description: Number of unique receiving addresses
                              example: '460'
                            numberOfUniqueSenders:
                              type: string
                              description: Number of unique sending addresses
                              example: '395'
                            timestamp:
                              type: string
                              format: date-time
                              description: Timestamp of the data point in ISO 8601 format
                              example: '2025-07-25T01:00:00Z'
                            transferVolume:
                              type: string
                              description: Total volume of transfers. Measured in USD.
                              example: '612098.87144'
                      metadata:
                        type: object
                        description: Additional metadata for the response
                        additionalProperties: true
      security:
      - ApiKeyAuth: []
      tags:
      - Analytics
    servers:
    - url: https://api.amberdata.com/blockchains
  /analytics/assets/information:
    get:
      summary: On-chain Analytics Supported Assets
      description: Retrieves information about supported assets for on-chain analytics.
      operationId: analytics-assets-information
      responses:
        '200':
          description: Successful request
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    description: HTTP status code
                    example: 200
                  title:
                    type: string
                    description: Status title
                    example: OK
                  description:
                    type: string
                    description: Status description
                    example: Successful request
                  payload:
                    type: object
                    properties:
                      data:
                        type: array
                        items:
                          type: object
                          properties:
                            arcId:
                              type: string
                              description: The unique Amberdata identifier for the asset
                              example: AMB:BTC000000000
                            arcName:
                              type: string
                              description: The full human-readable name of the asset
                              example: Bitcoin
                            arcSymbol:
                              type: string
                              description: The symbol/ticker - short name, abrreviated identifier - of the asset
                              example: BTC
                          required:
                          - arcId
                          - arcName
                          - arcSymbol
                      metadata:
                        type: object
                        description: Additional metadata for the response
                        properties:
                          next:
                            type: string
                            description: The url to request for the next page of results.
                        example: {}
                    required:
                    - data
                    - metadata
                required:
                - status
                - title
                - description
                - payload
      deprecated: false
      security:
      - ApiKeyAuth: []
      tags:
      - Analytics
    servers:
    - url: https://api.amberdata.com/blockchains
  /analytics/assets/{arcId}/marketcap:
    get:
      summary: Asset Market Cap
      description: Retrieves the market cap timeseries for a specific asset.
      operationId: analytics-asset-marketcap
      parameters:
      - name: arcId
        in: path
        description: The arcId of the asset (e.g., AMB:BTC000000000). Use the associated information endpoint to retrieve the arcId.
        schema:
          type: string
        required: true
      - name: startDate
        in: query
        description: '**[Optional]** Inclusive start date (default now() - 7 days).'
        schema:
          type: string
          format: date-time
      - name: endDate
        in: query
        description: '**[Optional]** Exclusive end date (default today).'
        schema:
          type: string
          format: date-time
      responses:
        '200':
          description: Successful request
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    description: HTTP status code
                    example: 200
                  title:
                    type: string
                    description: Status title
                    example: OK
                  description:
                    type: string
                    description: Status description
                    example: Successful request
                  payload:
                    type: object
                    properties:
                      data:
                        type: array
                        items:
                          type: object
                          properties:
                            arcId:
                              type: string
                              description: The unique identifier for the asset
                              example: AMB:BTC000000000
                            arcName:
                              type: string
                              description: The full name of the asset
                              example: Bitcoin
                            arcSymbol:
                              type: string
                              description: The symbol/ticker of the asset
                              example: BTC
                            circulatingSupply:
                              type: number
                              description: The circulating supply of the asset
                              example: 19594996.16066135
                            priceUSD:
                              type: number
                              description: The price of the asset in USD
                              example: 46189.23640263
                            marketCap:
                              type: number
                              description: The market capitalization in USD
                              example: 905077909973.43
                            timestamp:
                              type: string
                              format: date-time
                              description: The timestamp of the data point
                              example: '2024-01-10T00:00:00.000Z'
                          required:
                          - arcId
                          - arcName
                          - arcSymbol
                          - circulatingSupply
                          - priceUSD
                          - marketCap
                          - timestamp
                      metadata:
                        type: object
                        description: Additional metadata for the response
                        properties:
                          next:
                            type: string
                            description: The url to request for the next page of results
                        example: {}
                    required:
                    - data
                    - metadata
                required:
                - status
                - title
                - description
                - payload
      deprecated: false
      security:
      - ApiKeyAuth: []
      tags:
      - Analytics
    servers:
    - url: https://api.amberdata.com/blockchains
  /analytics/instruments/information:
    get:
      summary: Options Instruments
      description: This endpoint returns all available exchanges, currencies and option instruments. If a timestamp is used we can then filter the information for historical data.
      operationId: derivatives-information-instruments
      parameters:
      - name: exchange
        in: query
        description: "**[Optional]** The exchange for which to retrieve listed option instruments. \n**[Examples]** ` deribit | okex | bybit `"
        schema:
          type: string
      - name: currency
        in: query
        description: "**[Optional]** The underlying currency for which there are listed option instruments. \n**[Examples]** ` BTC | SOL_USDC `  \nNote: inverse options underlying currencies are formatted as (BTC, ETH) while linear options currency formats include the stable coin  (SOL_USDC)"
        schema:
          type: string
      - name: expiration
        in: query
        description: "**[Optional]** Filter records based on the specified expiration date. \n**[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`"
        schema:
          type: string
          format: date-time
      - name: putCall
        in: query
        description: "**[Optional]** The option type \n**[Examples]** ` C | P `"
        schema:
          type: string
      - name: strike
        in: query
        description: "**[Optional]** The option instrument subset with a given strike price. \n**[Examples]** ` 100000 | 3500 `"
        schema:
          type: integer
          format: int32
      - name: timestamp
        in: query
        description: "**[Optional]**  A select historical timestamp for which a list of option instruments were active at the time. \n**[Examples]** `  2024-04-03T08:00:00.000Z ` \nSupported Formats: milliseconds | ms* | iso | iso8601 | hr | human_readable"
        schema:
          type: string
          format: date-time
      - name: timeFormat
        in: query
        description: '**[Optional]** Time format of the timestamps in the return payload.

          **[Defaults]** `milliseconds | ms* | iso | iso8601 | hr | human_readable`'
        schema:
          type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 200
                  title:
                    type: string
                    example: OK
                  description:
                    type: string
                    example: Successful request
                  payload:
                    type: object
                    properties:
                      data:
                        type: array
                        items:
                          type: object
                          properties:
                            ts:
                              type: string
                              example: '2024-04-08 17:23:00.0'
                              description: Timestamp when the instrument information was recorded
                            exchange:
                              type: string
                              example: deribit
                              description: The exchange where the option instrument is listed
                            instrument:
                              type: string
                              example: DERIBIT-ETH-28MAR25-2000.0-P
                              description: The full instrument identifier normalized by Amberdata
                            nativeInstrument:
                              type: string
                              example: ETH-28MAR25-2000-P
                              description: The native instrument identifier provided by the exchange
                            multiplier:
                              type: integer
                              example: 1
                              description: The contract multiplier for the option instrument
                            putCall:
                              type: string
                              example: P
                              description: The option type - P for Put, C for Call
                            expiration:
                              type: string
                              example: '2025-03-28 08:00:00.0'
                              description: The expiration date and time of the option contract
                            currency:
                              type: string
                              example: ETH
                              description: The underlying currency/asset for the option
                            strike:
                              type: integer
                              example: 2000
                              description: The strike price of the option contract
              examples:
                Result:
                  value:
                    status: 200
                    title: OK
                    description: Successful request
                    payload:
                      data:
                      - ts: '2024-04-08 17:23:00.0'
                        exchange: deribit
                        instrument: DERIBIT-ETH-28MAR25-2000.0-P
                        nativeInstrument: ETH-28MAR25-2000-P
                        multiplier: 1
                        putCall: P
                        expiration: '2025-03-28 08:00:00.0'
                        currency: ETH
                        strike: 2000
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: {}
              schema:
                type: object
                properties: {}
      deprecated: false
      security:
      - ApiKeyAuth: []
      tags:
      - Analytics
    servers:
    - url: https://api.amberdata.com/markets/derivatives
  /analytics/futures-perpetuals/trade-aggregation-information:
    get:
      summary: (new) Information Perpetuals and Futures
      description: This endpoint provides instrument information for each exchange. Users can also query it to view the dataset's start and end dates. Optional parameters, such as exchange or currency, can be used to filter the dataset for specific information.
      operationId: derivatives-futures-perpetuals-information
      parameters:
      - name: currency
        in: query
        description: "**[Optional]** The underlying currency for which there are futures contracts/instruments. \n**[Examples]** ` BTC | ETH `"
        schema:
          type: string
          default: BTC
      - name: exchange
        in: query
        description: "**[Optional]** The underlying exchange for which there are futures contracts/instruments. \n**[Examples]** ` binance | deribit | bitmex `"
        schema:
          type: string
          default: binance
      - name: timeFormat
        in: query
        description: '**[Optional]** Time format of the timestamps in the return payload.

          **[Defaults]** `milliseconds | ms* | iso | iso8601 | hr | human_readable`'
        schema:
          type: string
          default: hr
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  title:
                    type: string
                  description:
                    type: string
                  payload:
                    type: object
              examples:
                Result:
                  value: {}
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value:
                    status: 200
                    title: OK
                    description: Successful request
                    payload:
                      data:
                      - endDate: 2025-04-18 00:00:00 000
                        exchange: binance
                        instrument: 1000000MOGUSDT
                        startDate: 2024-11-07 00:00:00 000
                      - endDate: 2025-04-18 00:00:00 000
                        exchange: binance
                        instrument: 1000BONKUSDC
                        startDate: 2024-05-02 00:00:00 000
                      - endDate: 2025-04-18 00:00:00 000
                        exchange: binance
                        instrument: 1000BONKUSDT
                        startDate: 2023-11-22 00:00:00 000
                      - endDate: 2022-04-11 00:00:00 000
                        exchange: binance
                        instrument: 1000BTTCUSDT
                        startDate: 2022-01-26 00:00:00 000
                      - endDate: 2025-04-18 00:00:00 000
                        exchange: binance
                        instrument: 1000CATUSDT
                        startDate: 2024-10-21 00:00:00 000
      deprecated: false
      security:
      - ApiKeyAuth: []
      tags:
      - Analytics
    servers:
    - url: https://api.amberdata.com/markets/derivatives
  /analytics/futures-perpetuals/depth/information:
    get:
      summary: Futures Depth Instruments
      description: This endpoint returns all available exchanges and futures/perpetual instruments with order book depth data.
      operationId: derivatives-information-instruments
      parameters:
      - name: exchange
        in: query
        description: "**[Optional]** The exchange for which to retrieve listed futures and perpetual instruments depth data. \n**[Examples]** ` deribit | okex | bybit `"
        schema:
          type: string
          default: deribit
      - name: instrument
        in: query
        description: "**[Optional]** The instrument for which there is depth data. \n**[Examples]** ` BTC-PERPETUAL` "
        schema:
          type: string
      - name: timeFormat
        in: query
        description: '**[Optional]** Time format of the timestamps in the return payload.

          **[Defaults]** `milliseconds | ms* | iso | iso8601 | hr | human_readable`'
        schema:
          type: string
          default: hr
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 200
                  title:
                    type: string
                    example: OK
                  description:
                    type: string
                    example: Successful request
                  payload:
                    type: object
                    properties:
                      data:
                        type: array
                        items:
                          type: object
                          properties:
                            endDate:
                              type: string
                              example: '2024-04-08 17:23:00.0'
                              description: Timestamp when the instrument information was last recorded
                            exchange:
                              type: string
                              example: deribit
                              description: The exchange where the instrument is listed
                            instrument:
                              type: string
                              example: BTC-PERPETUAL
                              description: The full instrument identifier
                            startDate:
                              type: string
                              example: '2024-04-08 17:23:00.0'
                              description: Timestamp when the instrument information was first recorded
              examples:
                Result:
                  value:
                    status: 200
                    title: OK
                    description: Successful request
                    payload:
 

# --- truncated at 32 KB (592 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/amberdata/refs/heads/main/openapi/amberdata-analytics-api-openapi.yml