perps-funding-pulse

Fetch current funding rate, next tick, open interest, and long/short skew for perpetual futures markets across major venues.

  • 2 Entrypoints
  • v1.0.0 Version
  • None Payments
65.108.87.255:8081

Entrypoints

Explore the capabilities exposed by this agent. Invoke with JSON, stream responses when available, and inspect pricing where monetization applies.

fetch_funding

Invoke

Return live funding metrics (funding_rate, time_to_next, open_interest, skew) for specified perpetuals markets across one or more venues.

Pricing Free
Invoke Endpoint POST /entrypoints/fetch_funding/invoke
Input Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "venue_ids": {
      "default": [
        "BINANCE",
        "BYBIT",
        "HYPERLIQUID",
        "OKX"
      ],
      "description": "List of venues to query",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "BINANCE",
          "BYBIT",
          "HYPERLIQUID",
          "OKX"
        ]
      }
    },
    "markets": {
      "default": [
        "BTC-USDT",
        "ETH-USDT"
      ],
      "description": "Markets to query, e.g. ['BTC-USDT', 'ETH-USDT', 'SOL-USDT']",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "venue_ids",
    "markets"
  ],
  "additionalProperties": false
}
Invoke with curl
curl -s -X POST \
  'http://65.108.87.255:8081/entrypoints/fetch_funding/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "venue_ids": [
          "BINANCE"
        ],
        "markets": [
          "string"
        ]
      }
    }
  '

echo

Invoke

Echo a message (health check)

Pricing Free
Invoke Endpoint POST /entrypoints/echo/invoke
Input Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "text": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
Invoke with curl
curl -s -X POST \
  'http://65.108.87.255:8081/entrypoints/echo/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "text": "string"
      }
    }
  '

Client Example: x402-fetch

Use the x402-fetch helpers to wrap a standard fetch call and automatically attach payments. This script loads configuration from .env, pays the facilitator, and logs both the response body and the decoded payment receipt.

import { config } from "dotenv";
import {
  decodeXPaymentResponse,
  wrapFetchWithPayment,
  createSigner,
  type Hex,
} from "x402-fetch";

config();

const privateKey = process.env.PRIVATE_KEY as Hex | string;
const baseURL = process.env.RESOURCE_SERVER_URL as string; // e.g. https://example.com
const endpointPath = process.env.ENDPOINT_PATH as string; // e.g. /weather
const url = `${baseURL}${endpointPath}`; // e.g. https://example.com/weather

if (!baseURL || !privateKey || !endpointPath) {
  console.error("Missing required environment variables");
  process.exit(1);
}

/**
 * Demonstrates paying for a protected resource using x402-fetch.
 *
 * Required environment variables:
 * - PRIVATE_KEY            Signer private key
 * - RESOURCE_SERVER_URL    Base URL of the agent
 * - ENDPOINT_PATH          Endpoint path (e.g. /entrypoints/echo/invoke)
 */
async function main(): Promise<void> {
  // const signer = await createSigner("solana-devnet", privateKey); // uncomment for Solana
  const signer = await createSigner("base-sepolia", privateKey);
  const fetchWithPayment = wrapFetchWithPayment(fetch, signer);

  const response = await fetchWithPayment(url, { method: "GET" });
  const body = await response.json();
  console.log(body);

  const paymentResponse = decodeXPaymentResponse(
    response.headers.get("x-payment-response")!
  );
  console.log(paymentResponse);
}

main().catch((error) => {
  console.error(error?.response?.data?.error ?? error);
  process.exit(1);
});

Manifest

Loading…
Fetching agent card…