개요

This document as JSON, so the full contract can be fetched from the API itself.

Endpoint

GET https://earn-api.quicknode.dev/functions/v1/api/v1/openapi.json

Authorization

Include the published apikey header. This read request is public and does not require a SIWE signature.

매개변수

This endpoint does not accept path or query parameters.

Example request

curl --request GET \
  --url 'https://earn-api.quicknode.dev/functions/v1/api/v1/openapi.json' \
  --header 'Accept: application/json' \
  --header 'apikey: <EARN_PUBLIC_API_KEY>'

답변

The response is the complete OpenAPI 3.1 contract used by the Earn API reference.

분야	유형	Required	설명
openapi	문자열	네	OpenAPI specification version used by the document.
정보	객체	네	API metadata, including its title, version, description, contact, and license.
info.title	문자열	네	Display name of the API.
info.version	문자열	네	Version of the Earn API contract.
info.summary	문자열	네	Short summary of the API.
info.description	문자열	네	Detailed API lifecycle, authorization, units, and stability information.
info.contact	객체	네	Name and URL of the API contact.
info.license	객체	네	Name and URL of the license that applies to the API.
servers	array<object>	네	Server definitions used to construct API request URLs.
servers[].url	문자열	네	Base URL of an API server.
servers[].description	문자열	네	Environment represented by the server URL.
security	array<object>	네	Global security requirements applied to API operations.
security[].apikey	배열	네	Declares the global `apikey` security scheme requirement.
tags	array<object>	네	Resource groups used to organize operations in the API reference.
tags[].name	문자열	네	Name of an API resource group.
tags[].description	문자열	네	Description of the operations included in the resource group.
paths	객체	네	Documented API paths and their supported HTTP operations.
paths.{path}.{method}	객체	아니요	Operation definition containing its ID, rate limit, tags, summary, description, parameters, request body, and responses where applicable.
components	객체	네	Reusable schemas, parameters, responses, examples, and security schemes.
components.schemas	객체	네	Reusable request and response schemas referenced by operations.
components.parameters	객체	네	Reusable path and query parameter definitions.
components.responses	객체	네	Reusable HTTP response definitions.
components.examples	객체	네	Reusable request and response examples.
components.securitySchemes	객체	네	Definition of the `apikey` header security scheme.

Example response excerpt

The full response contains every path and reusable component. This excerpt shows selected top-level values from the response:

{
	"openapi": "3.1.0",
	"info": {
		"title": "Quicknode Earn Public API",
		"version": "1.3.0",
		"summary": "HTTP API to drive Earn strategies end to end.",
		"contact": {
			"name": "Quicknode Earn",
			"url": "https://earn.quicknode.com"
		},
		"license": {
			"name": "Proprietary",
			"url": "https://www.quicknode.com/terms-of-service"
		}
	},
	"servers": [
		{
			"url": "https://earn-api.quicknode.dev/functions/v1/api",
			"description": "Production"
		}
	],
	"security": [
		{
			"apikey": []
		}
	],
	"tags": [
		{
			"name": "Discovery",
			"description": "Machine-readable API index and the self-served OpenAPI document."
		}
	]
}

HTTP responses

상태	설명
200	The OpenAPI 3.1 document.
429	Rate limit exceeded. `Retry-After` (seconds) tells you when to retry. Reads, feedback, and push writes are keyed per IP; create/update/delete are keyed per wallet+IP; deposit/withdraw/claim calldata is keyed per strategy+IP.

OpenAPI source

This page is based on operation getOpenapiDocument in the Earn OpenAPI 3.1 specification.