openapi: 3.2.0 info: title: Finage Market Data Crypto API description: Finage is a real-time and historical market data provider covering US and global stocks, forex, cryptocurrencies, indices, ETFs, bonds, and company fundamentals. This OpenAPI was generated by API Evangelist from Finage's own machine-readable docs database (https://api.finage.co.uk/op/v1/endpoints/list — the same JSON the docs at https://finage.co.uk/docs/api render); every path, parameter, and example comes from that source. All endpoints are read-only GET requests authenticated with an apikey query parameter. Responses must be requested with gzip Accept-Encoding (the API returns 406 "GZip compression required" otherwise). version: 1.0.0 contact: name: Finage Support email: support@finage.co.uk url: https://finage.co.uk x-apievangelist: generated: '2026-07-22' method: generated source: https://api.finage.co.uk/op/v1/endpoints/list servers: - url: https://api.finage.co.uk security: - apiKey: [] tags: - name: Crypto paths: /last/crypto/{symbol}: get: operationId: cryptoLastTradeApi summary: Crypto Last Trade API description: You can get the prices in Real-Time with this endpoint. tags: - Crypto parameters: - name: symbol in: path required: true description: Crypto symbol that you want to get price schema: type: string responses: '200': description: Crypto Last Trade API response. content: application/json: schema: type: object properties: symbol: type: string description: Symbol name price: type: number description: Latest price timestamp: type: integer format: int64 description: Timestamp [ms] example: symbol: BTCUSD price: 56385.08 timestamp: 1620757059440 '401': $ref: '#/components/responses/Unauthorized' /last/quote/crypto/{symbol}: get: operationId: cryptoLastQuoteApi summary: Crypto Last Quote API description: You can get the last quote prices in Real-Time with this endpoint. tags: - Crypto parameters: - name: symbol in: path required: true description: 'Symbol Name (eg: BTCUSD)' schema: type: string responses: '200': description: Crypto Last Quote API response. content: application/json: schema: type: object properties: symbol: type: string description: Symbol name ask: type: number description: Ask price asize: type: number description: Ask size bid: type: number description: Bid price bsize: type: number description: Bid size timestamp: type: integer format: int64 description: Timestamp [ms] example: symbol: BTCUSD ask: 56385.07 asize: 0.075349 bid: 56385.06 bsize: 0.36976 timestamp: 1620757064667 '401': $ref: '#/components/responses/Unauthorized' /agg/crypto/{symbol}/{multiply}/{time}/{from}/{to}: get: operationId: cryptoAggregatesApi summary: Crypto Aggregates API description: With the Crypto Market Aggregates API, you can get the tick bars of the crypto market. tags: - Crypto parameters: - name: symbol in: path required: true description: Symbol of the crypto schema: type: string - name: multiply in: path required: true description: Time multiplier [1, 3, 5, 15, 30] schema: type: string - name: time in: path required: true description: Size of the time. [minute, hour, day, week, month] schema: type: string - name: from in: path required: true description: Start date schema: type: string - name: to in: path required: true description: End date schema: type: string - name: limit in: query required: false description: Limit of the results. Default is 100, maximum allowed limit is 50000. Please set a limit if you are using the API in the production. schema: type: string - name: sort in: query required: false description: You can sort the results by timestamp. asc will return ascending results oldest to newest, desc will return descending results newest to oldest. Default is asc. schema: type: string responses: '200': description: Crypto Aggregates API response. content: application/json: schema: type: object properties: symbol: type: string description: Symbol Name totalResults: type: integer description: Result Count o: type: number description: Open Price h: type: number description: Highest Price l: type: number description: Lowest Price c: type: number description: Close Price v: type: integer description: Volume t: type: integer format: int64 description: Timestamp example: symbol: BTCUSD totalResults: 3 results: - o: 9164.33 h: 9775 l: 9142.52 c: 9613.82 v: 54480.149862462065 t: 1580860800000 - o: 9613.91 h: 9863.39 l: 9520 c: 9763.01 v: 61112.15618754777 t: 1580947200000 - o: 9763.01 h: 9885 l: 9683.9 c: 9805.2 v: 45132.69009042265 t: 1581033600000 '401': $ref: '#/components/responses/Unauthorized' /agg/crypto/prev-close/{symbol}: get: operationId: cryptoPreviousCloseApi summary: Crypto Previous Close API description: With the Crypto Previous Close endpoint, you can get the previous day's last tick bar of the crypto market. tags: - Crypto parameters: - name: symbol in: path required: true description: Symbol of the crypto schema: type: string responses: '200': description: Crypto Previous Close API response. content: application/json: schema: type: object properties: symbol: type: string description: Symbol Name totalResults: type: integer description: Result Count o: type: number description: Open Price h: type: number description: Highest Price l: type: number description: Lowest Price c: type: number description: Close Price v: type: integer description: Volume t: type: integer format: int64 description: Timestamp example: symbol: BTCUSD totalResults: 1 results: - o: 55816.14 h: 56850 l: 54370 c: 56672.24 v: 57725.397404 t: 1620691200000 '401': $ref: '#/components/responses/Unauthorized' /convert/crypto/{from}/{to}/{amount}: get: operationId: cryptoConverterApi summary: Crypto Converter API description: You can convert crypto by using this API. (eg. BTC to ETH, USD to DOGE, SHIB to BTC etc.) tags: - Crypto parameters: - name: from in: path required: true description: '"From" symbol of the crypto.' schema: type: string - name: to in: path required: true description: '"To" symbol of the crypto.' schema: type: string - name: amount in: path required: true description: The amount to convert. schema: type: string responses: '200': description: Crypto Converter API response. content: application/json: schema: type: object properties: from: type: string description: '"From" symbol of the crypto.' to: type: string description: '"To" symbol of the crypto.' amount: type: integer description: The amount to convert. value: type: number description: Converted amount. timestamp: type: integer format: int64 description: Timestamp [ms] example: from: BTC to: ETH amount: 2 value: 58.7583 timestamp: 1732019680104 '401': $ref: '#/components/responses/Unauthorized' /snapshot/crypto: get: operationId: cryptoSnapshotApi summary: Crypto Snapshot API description: Crypto Snapshot API will give you access to all available crypto with one single API request. You can get the latest trades, quotes or both of them with one request. tags: - Crypto parameters: - name: quotes in: query required: true description: Enable or disable last quotes. Default is true. schema: type: string - name: trades in: query required: true description: Enable or disable last trades. Default is false. schema: type: string - name: symbols in: query required: true description: You can get the data from specific symbols by using this query. If you leave it empty, you will get the all available last data. (Separate symbols with commas.) schema: type: string responses: '200': description: Crypto Snapshot API response. content: application/json: schema: type: object properties: s: type: string description: Crypto symbol p: type: number description: Last trade price a: type: number description: Last ask price b: type: number description: Last bid price asz: type: integer description: Ask size bsz: type: integer description: Bid size sz: type: integer description: Trade size t: type: integer format: int64 description: Timestamp (microseconds) totalResults: type: integer description: Total incoming symbol number. example: totalResults: 2 lastQuotes: - s: BTCUSD a: 44361.36 b: 44356.82 asz: 0.00043 bsz: 0.19834 t: 1644505310197 - s: DOGEUSD a: 0.1548 b: 0.1547 asz: 133376 bsz: 138504 t: 1644505310197 lastTrades: - s: BTCUSD p: 44447.81 sz: 0.1 t: 1644505310197 - s: DOGEUSD p: 0.1550595 sz: 136211.88 t: 1644505310197 '401': $ref: '#/components/responses/Unauthorized' components: responses: Unauthorized: description: Missing or invalid API key, or your plan does not include this market. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Please use your APIKey to make a request. schemas: Error: type: object description: Finage error envelope — a single error string. properties: error: type: string description: Human-readable error message. securitySchemes: apiKey: type: apiKey name: apikey in: query description: Finage API key, passed as the apikey query parameter on every request. Get one at https://moon.finage.co.uk/register. externalDocs: description: Finage API documentation url: https://finage.co.uk/docs/api