Perp positions and trades
Perp positions and trades: Hyperliquid perp positions and trades for a wallet or a perp token, or the busiest perp markets. Use when an agent needs Hyperliquid positions and trades for a wallet, or the busiest perp markets. $0.05 this call, in USDC on Base; you pay only if it succeeds. HivemindOS SuperAgent API.
Answeringour last check, 2026-10-24
1 of 1checks answered this week
295 msmedian answer time
$0.05listed price per call
$0.05price it asked us
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://api.hivemindos.app/v1/x402/onchain-intelligence/perps.brief
| Category | Market data |
|---|---|
| Provider host | api.hivemindos.app |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 3 from 2 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-10-24 | valid payment request | 402 | $0.05 | 295 ms |
Example input (from the provider)
{
"body": {
"tokenSymbol": "BTC"
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": false,
"properties": {
"address": {
"description": "EVM wallet address (0x\u2026).",
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
},
"date": {
"description": "The window to read, as YYYY-MM-DD dates. Defaults to recent days.",
"properties": {
"from": {
"format": "date",
"type": "string"
},
"to": {
"format": "date",
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"request": {
"description": "The read in plain words, naming the address, $SYMBOL, chain or exchange.",
"maxLength": 2000,
"type": "string"
},
"tokenSymbol": {
"description": "A perp market symbol, such as BTC.",
"maxLength": 20,
"type": "string"
}
},
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"chargedCredits": {
"description": "Agent Credits the service charged (500 = $1).",
"type": "number"
},
"followUp": {
"description": "apiKey holding the credits the call did not use, or null when none are left.",
"properties": {
"apiKey": {
"type": "string"
},
"keyId": {
"type": [
"string",
"null"
]
},
"remainingCredits": {
"type": "number"
},
"use": {
"type": "string"
}
},
"type": [
"object",
"null"
]
},
"ok": {
"description": "true when the call worked; a failed call is never charged.",
"type": "boolean"
},
"operationId": {
"type": "string"
},
"result": {
"description": "Open perp positions and recent trades for the wallet or token, or the busiest perp markets."
},
"serviceId": {
"type": "string"
},
"status": {
"description": "The service's own HTTP status.",
"type": "integer"
},
"x402": {
"description": "The payment: settled only after the call worked.",
"properties": {
"charged": {
"type": "boolean"
},
"network": {
"type": [
"string",
"null"
]
},
"payer": {
"type": [
"string",
"null"
]
},
"priceUsd": {
"type": "number"
},
"receiptId": {
"type": "string"
},
"transaction": {
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
"required": [
"ok",
"x402"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}