find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/ribbon-finance:ribbon-finance-instruments-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Aevo Exchange Public REST Instruments API
  description: Public unauthenticated REST API for Aevo exchange (the trading platform evolved from Ribbon Finance) providing market data, vault statistics, options pricing, funding rates, and other openly available trading information. No authentication required for these endpoints.
  version: 1.0.0
  contact:
    name: Aevo Support
    url: https://docs.aevo.xyz/
servers:
- url: https://api.aevo.xyz
  description: Aevo Exchange production server
tags:
- name: Instruments
  description: Instrument and market information
paths:
  /markets:
    get:
      tags:
      - Instruments
      summary: Get markets
      description: Returns a list of all available instruments/markets on the exchange.
      operationId: getMarkets
      parameters:
      - name: asset
        in: query
        required: false
        description: Name of underlying asset.
        schema:
          type: string
          example: ETH
      - name: instrument_type
        in: query
        required: false
        description: Type of instrument.
        schema:
          type: string
          enum:
          - OPTION
          - PERPETUAL
          - SPOT
      responses:
        '200':
          description: List of markets
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Instrument'
        '400':
          $ref: '#/components/responses/BadRequest'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
  /assets:
    get:
      tags:
      - Instruments
      summary: Get available assets
      description: Returns a list of all available underlying assets on the exchange.
      operationId: getAssets
      responses:
        '200':
          description: List of assets
          content:
            application/json:
              schema:
                type: object
                properties:
                  assets:
                    type: array
                    items:
                      type: string
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
  /expiries:
    get:
      tags:
      - Instruments
      summary: Get available expiries
      description: Returns the list of available option expiry dates.
      operationId: getExpiries
      parameters:
      - name: asset
        in: query
        required: false
        schema:
          type: string
          example: ETH
      responses:
        '200':
          description: List of expiries
          content:
            application/json:
              schema:
                type: object
                properties:
                  expiries:
                    type: array
                    items:
                      type: string
        '400':
          $ref: '#/components/responses/BadRequest'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  responses:
    InternalError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    BadRequest:
      description: Malformed request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    RateLimited:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    Instrument:
      type: object
      properties:
        instrument_id:
          type: string
          description: Numeric instrument identifier
        instrument_name:
          type: string
          example: ETH-30JUN23-1600-C
        instrument_type:
          type: string
          enum:
          - OPTION
          - PERPETUAL
          - SPOT
        underlying_asset:
          type: string
          example: ETH
        quote_asset:
          type: string
          example: USDC
        price_step:
          type: string
          description: Allowed increments in price
        amount_step:
          type: string
          description: Allowed increments in contract amount
        min_order_value:
          type: string
        max_order_value:
          type: string
        max_notional_value:
          type: string
        mark_price:
          type: string
        forward_price:
          type: string
        index_price:
          type: string
        is_active:
          type: boolean
          description: Whether trading is active
        option_type:
          type: string
          enum:
          - put
          - call
          description: Option type (only for options)
        expiry:
          type: string
          description: Expiry timestamp in UNIX nanoseconds (only for options)
        strike:
          type: string
          description: Strike price (only for options)
        greeks:
          type: object
          properties:
            delta:
              type: string
            gamma:
              type: string
            rho:
              type: string
            theta:
              type: string
            vega:
              type: string
            iv:
              type: string
        max_leverage:
          type: string
          description: Maximum leverage (only for perpetuals)
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          example: ERR_MALFORMED_REQUEST