Quickstart

Tulip uses Robinhood Chain for credits, markets, permits, and settlement. Inference requests travel through the Tulip Gateway to an eligible provider endpoint.

This guide covers Tulip v1’s production flow on Robinhood Chain mainnet. Version 1 routes inference through verified Hugging Face Inference Endpoints; later versions may support additional vendors.

Prerequisites

You need:

An EVM wallet that supports Robinhood Chain.
Native gas on Robinhood Chain.
USDG if you plan to buy model credits.
A Tulip Gateway API key if you plan to call the Gateway directly.

Complete your first inference request

Connect to Robinhood Chain

Add Robinhood Chain to your wallet and confirm chain ID 4663. See Network and addresses.

Choose a model market

Open Explore, search by model name or Hugging Face repository, and verify the pinned revision before trading.

Buy model credits

Open the model’s market, enter the USDG amount, review the quote and minimum received, then approve and submit the swap.The swap executes through Permit2 and the Universal Router against the canonical Uniswap v4 pool.

Create an inference permit

Open Credits, select a credit held by your wallet, choose how much to make available, and approve the escrow deposit.A permit is bound to one model. You may leave provider selection open or pin the permit to one provider offer.

Send a request

Open Chat, select the model, choose the permit, and send a message. The gateway verifies the permit, selects an eligible provider, reserves the maximum quoted charge, and forwards the request.

Review the charge

The provider response includes Tulip request, quote, offer, and tariff identifiers. After metering, the gateway signs a usage receipt for on-chain settlement.

A completed request is charged in the model’s credit, not in USDG. Any unused reserved amount remains available in the permit.

Use the Gateway directly

The Gateway accepts an OpenAI-compatible chat request with Tulip authorization headers.

curl "$TULIP_GATEWAY_URL/v1/chat/completions" \
  -H "Authorization: Bearer $TULIP_API_KEY" \
  -H "X-Tulip-Permit: $PERMIT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "owner/repository",
    "messages": [{"role": "user", "content": "Explain this model."}],
    "max_completion_tokens": 256
  }'

Set TULIP_GATEWAY_URL to the production base URL provided with your Tulip API credentials.

Prerequisites

Complete your first inference request

Use the Gateway directly

Next steps

Trade model credits

Inference permits

​Prerequisites

​Complete your first inference request

​Use the Gateway directly

​Next steps

Trade model credits

Inference permits

Prerequisites

Complete your first inference request

Use the Gateway directly

Next steps