Ondo Finance API Keys API
The API Keys API from Ondo Finance — 3 operation(s) for api keys.
The API Keys API from Ondo Finance — 3 operation(s) for api keys.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/ondo-finance:ondo-finance-api-keys-api"
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.
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: 3.2.0
info:
title: Ondo Perps REST API Keys API
version: '1.0'
description: 'REST API for Ondo Perps: account, wallet, deposits/withdrawals, API keys, and perpetual futures trading.'
servers:
- url: https://api.ondoperps.xyz
security:
- BearerAuth: []
tags:
- name: API Keys
paths:
/v1/api_keys:
get:
summary: List API Keys
description: Returns API keys for the authenticated account.
operationId: listApiKeys
tags:
- API Keys
security:
- BearerAuth: []
- ApiKeyAuth: []
responses:
'200':
description: List of API keys
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/GenericResponse'
- type: object
properties:
result:
type: array
items:
$ref: '#/components/schemas/ApiKeyInfo'
example:
success: true
result:
- keyId: key_abc123
name: Trading Bot
createdAt: '2025-01-01T00:00:00Z'
scopes:
- read
- trade
whitelistedIPs:
- 192.168.1.1
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/TooManyRequests'
'500':
$ref: '#/components/responses/InternalServerError'
post:
summary: Create API Key
description: Create a new API key. The secret is returned only once.
operationId: createApiKey
tags:
- API Keys
security:
- BearerAuth: []
- ApiKeyAuth: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ApiKeysCreateRequest'
responses:
'200':
description: Created API key (includes secret)
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/GenericResponse'
- type: object
properties:
result:
$ref: '#/components/schemas/ApiKeyCreateResult'
example:
success: true
result:
keyId: key_abc123
name: Trading Bot
createdAt: '2025-01-01T00:00:00Z'
scopes:
- read
- trade
secretKey: sk_live_abc123def456ghi789...
'400':
description: Bad request. The request was malformed or failed validation.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: false
error:
type: string
description: Human-readable error message
error_code:
type: string
enum:
- bad_query_param
example:
success: false
error: Description of the error
error_code: bad_query_param
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/TooManyRequests'
'500':
$ref: '#/components/responses/InternalServerError'
/v1/api_keys/{apiKeyID}:
delete:
summary: Delete API Key
description: Delete an API key by ID.
operationId: deleteApiKey
tags:
- API Keys
security:
- BearerAuth: []
- ApiKeyAuth: []
parameters:
- name: apiKeyID
in: path
required: true
schema:
type: string
responses:
'200':
description: Deleted
content:
application/json:
schema:
$ref: '#/components/schemas/GenericResponse'
example:
success: true
'400':
description: Bad request. The request was malformed or failed validation.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: false
error:
type: string
description: Human-readable error message
error_code:
type: string
enum:
- api_key_not_found
example:
success: false
error: Description of the error
error_code: api_key_not_found
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/TooManyRequests'
'500':
$ref: '#/components/responses/InternalServerError'
/v1/api_keys/{apiKeyID}/ip_whitelist:
post:
summary: Set API Key IP Whitelist
description: Set or update IP whitelist for an API key.
operationId: setApiKeyIpWhitelist
tags:
- API Keys
security:
- BearerAuth: []
- ApiKeyAuth: []
parameters:
- name: apiKeyID
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ApiKeyWhitelistRequest'
responses:
'200':
description: Updated
content:
application/json:
schema:
$ref: '#/components/schemas/GenericResponse'
example:
success: true
'400':
description: Bad request. The request was malformed or failed validation.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: false
error:
type: string
description: Human-readable error message
error_code:
type: string
enum:
- api_key_not_found
- too_many_ips
example:
success: false
error: Description of the error
error_code: api_key_not_found
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/TooManyRequests'
'500':
$ref: '#/components/responses/InternalServerError'
delete:
summary: Remove API Key IP Whitelist Entry
description: Remove an IP address from the whitelist for an API key.
operationId: deleteApiKeyIpWhitelist
tags:
- API Keys
security:
- BearerAuth: []
- ApiKeyAuth: []
parameters:
- name: apiKeyID
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- ip
properties:
ip:
type: string
description: IP address to remove from the whitelist
responses:
'200':
description: IP removed from whitelist
content:
application/json:
schema:
$ref: '#/components/schemas/GenericResponse'
example:
success: true
'400':
description: Bad request. The request was malformed or failed validation.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: false
error:
type: string
description: Human-readable error message
error_code:
type: string
enum:
- api_key_not_found
example:
success: false
error: Description of the error
error_code: api_key_not_found
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/TooManyRequests'
'500':
$ref: '#/components/responses/InternalServerError'
components:
schemas:
ApiKeyInfo:
type: object
required:
- keyId
- name
- createdAt
- scopes
properties:
keyId:
type: string
description: API key ID
name:
type: string
description: Key name
createdAt:
type: string
format: date-time
description: When the key was created
scopes:
type: array
items:
type: string
description: Permitted scopes
whitelistedIPs:
type: array
items:
type: string
description: Whitelisted IP addresses
ApiKeyCreateResult:
type: object
required:
- keyId
- name
- createdAt
- scopes
- secretKey
properties:
keyId:
type: string
description: API key ID
name:
type: string
description: Key name
createdAt:
type: string
format: date-time
description: When the key was created
scopes:
type: array
items:
type: string
description: Permitted scopes
secretKey:
type: string
description: API secret key. Only returned once at creation time.
ApiKeyWhitelistRequest:
type: object
required:
- ip
properties:
ip:
type: string
description: IP address to whitelist
example: 192.168.1.1
GenericResponse:
type: object
required:
- success
properties:
success:
type: boolean
description: Whether the request was successful
example: true
error:
type: string
description: Error message, present only on failure
example: ''
error_code:
type: string
description: Semantic error code. See each endpoint's error responses for the specific codes it can return.
deprecated:
type: string
description: Deprecation notice, if applicable
example: ''
ApiKeysCreateRequest:
type: object
required:
- name
- scopes
properties:
name:
type: string
description: Human-readable name for the API key
example: Trading Bot
scopes:
type: array
items:
type: string
description: Permission scopes for the API key
example:
- read_only
- transfer
responses:
TooManyRequests:
description: Rate limit exceeded. Slow down request frequency.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: false
error:
type: string
description: Human-readable error message
error_code:
type: string
enum:
- too_many_requests
example:
success: false
error: Description of the error
error_code: too_many_requests
Forbidden:
description: Access denied. The authenticated account does not have permission.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: false
error:
type: string
description: Human-readable error message
error_code:
type: string
enum:
- account_closed
- account_not_allowed
- forbidden
- ip_not_permitted
- key_doesnt_have_scope
example:
success: false
error: Description of the error
error_code: account_not_allowed
Unauthorized:
description: Authentication required. Provide a valid JWT or API key.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: false
error:
type: string
description: Human-readable error message
error_code:
type: string
enum:
- api_key_not_found
- auth_expired
- auth_invalid
- auth_missing
- failed_to_decode_hex_signature
- failed_to_parse_timestamp
- signature_mismatch
- timestamp_too_far
example:
success: false
error: Description of the error
error_code: auth_missing
InternalServerError:
description: Internal server error.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: false
error:
type: string
description: Human-readable error message
error_code:
type: string
enum:
- server_is_busy
- service_unavailable
- unknown
example:
success: false
error: Description of the error
error_code: unknown
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
ApiKeyAuth:
type: apiKey
in: header
name: X-API-KEY-ID