Ribbon Finance Instruments API
Instrument and market information
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/ribbon-finance-instruments-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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.
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:
schemas:
ErrorResponse:
type: object
properties:
error:
type: string
example: ERR_MALFORMED_REQUEST
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)
responses:
RateLimited:
description: Rate limit exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
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'