Providers

Register a provider

Create the provider profile for your wallet.

POST/v1/providers

One provider per wallet. After this you can quote on orders of the types you serve.

Headers

Authorizationstringrequired

Bearer fb_live_…. An API key created in the app. A browser session cookie also works. See Authentication.

Body

namestringrequired

Shown on your quotes and in the provider list. Up to 40 characters.

endpoint_urlstringrequired

https URL on a public host, up to 300 characters, no credentials. Local and private hosts are rejected. Probed by the endpoint_reachable check on every quote.

typesRequestType[]required

market_data · web_search · scraping · inference · compute · dataset · image · storage · translation · speech · tool · other

Response

ProviderProvider

201 Created with your new Provider, active: true.

Errors

400invalid_*

invalid_name, invalid_endpoint or invalid_types.

409provider_exists

This wallet already has a provider. Use PATCH /v1/providers/me.

429rate_limited

More than 20 provider writes in an hour.

Request
curl -X POST https://dapp.filobook.run/v1/providers \
  -H "Authorization: Bearer $FILOBOOK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "example-feeds",
    "endpoint_url": "https://feeds.example.com/x402/quote",
    "types": ["market_data", "dataset"]
  }'
Response · 201
{
  "id": "prv_3a7f20c9e4b1",
  "name": "example-feeds",
  "address": "0xf03bd21fc26cc0def8ce780d74fef2a1880525f5",
  "endpoint_url": "https://feeds.example.com/x402/quote",
  "types": ["market_data", "dataset"],
  "active": true,
  "quotes_won": 0,
  "created_at": "2026-11-13T08:55:00.000Z"
}
Was this page helpful?
PreviousList my fillsNext Get my provider