API Reference

Kepto Gateway API

The gateway turns plain HTTP requests into on-chain actions on Robinhood Chain: it holds a funded wallet, escrows KEP, uploads your bytes to storage providers, and verifies every retrieval against the on-chain Merkle root. 33 endpoints cover files, storage deals, real-world assets, and staked equity, all over ordinary HTTPS with a Bearer key.

Authentication Try it in the playground

Base URL

All endpoints are served from a single host. Paths below are relative to it.

GEThttps://gateway.kepto.xyz

Quickstart

The status endpoint requires no authentication and reports the chain, contract addresses, and current upload availability — a good first call to verify connectivity. Everything else needs a Bearer key; see Authentication to get one.

Terminal

curl https://gateway.kepto.xyz/api/v1/status

Limits and allowances

200 MiB per key — each API key has a cumulative lifetime upload allowance. Deleting a file does not refund it.
50 MiB per upload — the maximum accepted size for a single request body.
Key issuance is rate limited per client IP and UTC day, and uploads are refused when provider capacity headroom would be crossed (HTTP 507).

iNote

The exact limits for the gateway you are talking to are reported live by GET /api/v1/status as freeTierMaxBytes and maxFileSizeBytes.