# POST /info · API reference · Femtos

> Hyperliquid’s /info request bodies, answered from our node. POST /info on HyperCore: parameters, response fields and a live call per layer.

- Base URL: `https://api.femtos.xyz/v1` (REST) · `wss://api.femtos.xyz/v1/ws` (WebSocket) · MCP: `https://api.femtos.xyz/mcp`
- Auth: `Authorization: Bearer $FEMTOS_KEY`. Free key: https://femtos.xyz/account/new (browser), or with
  no browser: `GET https://femtos.xyz/accounts/agent/challenge`, solve its proof of work, then `POST https://femtos.xyz/accounts/agent/signup`
  (https://femtos.xyz/agents.md#agent-onboarding)
- Decimals are exact strings, times Unix milliseconds, addresses lowercase `0x`
- Whole API in one file: https://femtos.xyz/agents.md · OpenAPI: https://api.femtos.xyz/v1/openapi.json · Index: https://femtos.xyz/llms.txt
- Page with live calls: https://femtos.xyz/reference/hl/info

## POST /info — POST `/info`

Hyperliquid’s /info request bodies, answered from our node.

Same request bodies as `https://api.hyperliquid.xyz/info`, on `https://api.femtos.xyz/info` with `Authorization: Bearer $FEMTOS_KEY`.

| Field | Type | Meaning |
|---|---|---|
| `allMids · l2Book · metaAndAssetCtxs` | type | market state |
| `candleSnapshot · fundingHistory` | type | history by coin and window |
| `userFills · userFillsByTime · historicalOrders` | type | one account |
| `body · answer` | JSON | same as api.hyperliquid.xyz/info |

Types served (80; * = required, the answer is Hyperliquid's):

| `type` | Other fields | Counts as | Answer |
|---|---|---|---|
| `allMids` | dex | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-mids-for-all-coins |
| `openOrders` | user*, dex | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-open-orders |
| `frontendOpenOrders` | user*, dex | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-open-orders-with-additional-frontend-info |
| `userFills` | user*, aggregateByTime | heavy | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills |
| `userFillsByTime` | user*, startTime*, endTime, aggregateByTime | heavy | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills-by-time |
| `userRateLimit` | user* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-user-rate-limits |
| `orderStatus` | user*, oid* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-order-status-by-oid-or-cloid |
| `l2Book` | coin*, nSigFigs, mantissa | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#l2-book-snapshot |
| `candleSnapshot` | req* | heavy over 30 days | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#candle-snapshot |
| `maxBuilderFee` | user*, builder* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#check-builder-fee-approval |
| `historicalOrders` | user* | heavy | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-historical-orders |
| `userTwapSliceFills` | user* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-twap-slice-fills |
| `subAccounts` | user* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-subaccounts |
| `vaultDetails` | vaultAddress*, user | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-details-for-a-vault |
| `userVaultEquities` | user* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-vault-deposits |
| `userRole` | user* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-role |
| `portfolio` | user* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-portfolio |
| `referral` | user* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-referral-information |
| `userFees` | user* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-fees |
| `delegations` | user* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-delegations |
| `delegatorSummary` | user* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-summary |
| `delegatorHistory` | user* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-history |
| `delegatorRewards` | user* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-rewards |
| `userDexAbstraction` | user* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-hip-3-dex-abstraction-state |
| `userAbstraction` | user* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-abstraction-state |
| `borrowLendUserState` | user* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-borrowlend-user-state |
| `borrowLendReserveState` | token* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-borrowlend-reserve-state |
| `allBorrowLendReserveStates` | - | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-all-borrowlend-reserve-states |
| `approvedBuilders` | user* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-approved-builders-for-user |
| `perpDexs` | - | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-all-perpetual-dexs |
| `meta` | dex | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-metadata-universe-and-margin-tables |
| `metaAndAssetCtxs` | dex | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-asset-contexts-includes-mark-price-current-funding-open-interest-etc |
| `clearinghouseState` | user*, dex | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-users-perpetuals-account-summary |
| `userFunding` | user*, startTime*, endTime | heavy | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-a-users-funding-history-or-non-funding-ledger-updates |
| `userNonFundingLedgerUpdates` | user*, startTime*, endTime | heavy | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-a-users-funding-history-or-non-funding-ledger-updates |
| `fundingHistory` | coin*, startTime*, endTime | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-historical-funding-rates |
| `predictedFundings` | - | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-predicted-funding-rates-for-different-venues |
| `perpsAtOpenInterestCap` | dex | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#query-perps-at-open-interest-caps |
| `perpDeployAuctionStatus` | - | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-information-about-the-perp-deploy-auction |
| `activeAssetData` | user*, coin* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-users-active-asset-data |
| `perpDexLimits` | dex* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-builder-deployed-perp-market-limits |
| `perpDexStatus` | dex* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#get-perp-market-status |
| `allPerpMetas` | - | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-all-perpetuals-metadata-universe-and-margin-tables |
| `perpAnnotation` | coin* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perp-annotation |
| `perpCategories` | - | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perp-categories |
| `perpConciseAnnotations` | - | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-concise-perp-annotations |
| `spotMeta` | - | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-spot-metadata |
| `spotMetaAndAssetCtxs` | - | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-spot-asset-contexts |
| `spotClearinghouseState` | user* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-a-users-token-balances |
| `spotDeployState` | user* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-information-about-the-spot-deploy-auction |
| `spotPairDeployAuctionStatus` | - | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-information-about-the-spot-pair-deploy-auction |
| `tokenDetails` | tokenId* | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-information-about-a-token |
| `outcomeMeta` | - | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-outcome-metadata |
| `settledOutcome` | outcome | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-information-about-a-settled-outcome |
| `outcomeDeployerLimits` | venue | rest | https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-outcome-deployer-limits |
| `recentTrades` | coin* | rest | not in Hyperliquid's docs |
| `exchangeStatus` | - | rest | not in Hyperliquid's docs |
| `webData2` | user* | rest | not in Hyperliquid's docs |
| `vaultSummaries` | - | rest | not in Hyperliquid's docs |
| `leadingVaults` | - | rest | not in Hyperliquid's docs |
| `validatorSummaries` | - | rest | not in Hyperliquid's docs |
| `validatorL1Votes` | - | rest | not in Hyperliquid's docs |
| `liquidatable` | - | rest | not in Hyperliquid's docs |
| `maxMarketOrderNtls` | - | rest | not in Hyperliquid's docs |
| `marginTable` | - | rest | not in Hyperliquid's docs |
| `twapHistory` | user* | rest | not in Hyperliquid's docs |
| `userTwapSliceFillsByTime` | user*, startTime* | rest | not in Hyperliquid's docs |
| `subAccounts2` | - | rest | not in Hyperliquid's docs |
| `extraAgents` | user* | rest | not in Hyperliquid's docs |
| `userToMultiSigSigners` | user* | rest | not in Hyperliquid's docs |
| `isVip` | - | rest | not in Hyperliquid's docs |
| `preTransferCheck` | - | rest | not in Hyperliquid's docs |
| `usdcRouting` | - | rest | not in Hyperliquid's docs |
| `gossipRootIps` | - | rest | not in Hyperliquid's docs |
| `gossipPriorityAuctionStatus` | - | rest | not in Hyperliquid's docs |
| `outcomeTemplates` | - | rest | not in Hyperliquid's docs |
| `userBorrowLendInterest` | - | rest | not in Hyperliquid's docs |
| `validatorStats` | - | rest | not in Hyperliquid's docs |
| `alignedQuoteTokenInfo` | - | rest | not in Hyperliquid's docs |
| `nonUserFundingUpdates` | - | rest | not in Hyperliquid's docs |

## Related (Hyperliquid-compatible)

- [Hyperliquid WS](https://femtos.xyz/reference/hl/ws.md) `WS /ws`: Hyperliquid’s WebSocket subscriptions, served from our node. (HyperCore)

Every page: https://femtos.xyz/reference.md