{"openapi":"3.1.0","info":{"title":"PumpView Solana Trades API","description":"Live Solana trade data and client-signed trading via REST and MCP. Kolibrio delivery, 0.5% swap fee, confirmed execution reports, account and API-key volume statistics. See https://pumpview.fun/developers/quickstart for WSS, MCP and wallet payment instructions.","version":"1.2.0"},"paths":{"/v1/plans":{"get":{"summary":"Plans","operationId":"plans_v1_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/v1/health":{"get":{"summary":"Health","operationId":"health_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/v1/swaps/config":{"get":{"summary":"Trading Policy","operationId":"trading_policy_v1_swaps_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/v1/swaps/build":{"post":{"tags":["Trading"],"summary":"Swap Build","description":"Prepare and simulate an ExactIn swap. Free API access; client signs locally.","operationId":"swap_build_v1_swaps_build_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwapBuild"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/swaps/usage":{"get":{"tags":["Trading"],"summary":"Trading Usage","description":"All-time confirmed swap volume for this account and its API keys. USD is a build-time price estimate.","operationId":"trading_usage_v1_swaps_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKey":[]}]}},"/v1/swaps/{swap_id}/submit":{"post":{"tags":["Trading"],"summary":"Swap Submit","description":"Broadcast only the original signed transaction through Kolibrio. Check status after a timeout.","operationId":"swap_submit_v1_swaps__swap_id__submit_post","parameters":[{"name":"swap_id","in":"path","required":true,"schema":{"type":"string","title":"Swap Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwapSubmit"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/swaps/{swap_id}":{"get":{"tags":["Trading"],"summary":"Swap Status","description":"Read the status of this account's swap. Never creates a replacement trade.","operationId":"swap_status_v1_swaps__swap_id__get","parameters":[{"name":"swap_id","in":"path","required":true,"schema":{"type":"string","title":"Swap Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/agent/challenge":{"post":{"summary":"Challenge","operationId":"challenge_v1_agent_challenge_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[]}},"/v1/agent/access":{"post":{"summary":"Agent Access","operationId":"agent_access_v1_agent_access_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[]}},"/v1/invoices":{"post":{"summary":"Invoice","operationId":"invoice_v1_invoices_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/invoices/{invoice_id}":{"get":{"summary":"Invoice Status","operationId":"invoice_status_v1_invoices__invoice_id__get","parameters":[{"name":"invoice_id","in":"path","required":true,"schema":{"type":"string","title":"Invoice Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/invoices/{invoice_id}/transaction":{"post":{"summary":"Invoice Transaction","operationId":"invoice_transaction_v1_invoices__invoice_id__transaction_post","parameters":[{"name":"invoice_id","in":"path","required":true,"schema":{"type":"string","title":"Invoice Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/invoices/{invoice_id}/confirm":{"post":{"summary":"Confirm Invoice","operationId":"confirm_invoice_v1_invoices__invoice_id__confirm_post","parameters":[{"name":"invoice_id","in":"path","required":true,"schema":{"type":"string","title":"Invoice Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Confirmation"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/trades/query":{"post":{"summary":"Query Trades","operationId":"query_trades_v1_trades_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradeQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/trades":{"get":{"summary":"Recent Trades","operationId":"recent_trades_v1_trades_get","parameters":[{"name":"mint","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mint"}},{"name":"wallet","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wallet"}},{"name":"after","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"After"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}}},"components":{"schemas":{"AgentRequest":{"properties":{"wallet":{"type":"string","maxLength":44,"minLength":32,"title":"Wallet"},"nonce":{"type":"string","maxLength":100,"minLength":20,"title":"Nonce"},"signature":{"type":"string","maxLength":100,"minLength":80,"title":"Signature"},"name":{"type":"string","maxLength":80,"minLength":1,"title":"Name","default":"Autonomous agent"}},"type":"object","required":["wallet","nonce","signature"],"title":"AgentRequest"},"Confirmation":{"properties":{"signature":{"type":"string","maxLength":100,"minLength":80,"title":"Signature"}},"type":"object","required":["signature"],"title":"Confirmation"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"InvoiceRequest":{"properties":{"plan":{"type":"string","maxLength":40,"title":"Plan"}},"type":"object","required":["plan"],"title":"InvoiceRequest"},"KeyRequest":{"properties":{"name":{"type":"string","maxLength":80,"minLength":1,"title":"Name","default":"My agent"},"budget":{"anyOf":[{"type":"integer","maximum":1000000000.0,"minimum":1.0},{"type":"null"}],"title":"Budget"}},"type":"object","title":"KeyRequest"},"SwapBuild":{"properties":{"request_id":{"type":"string","maxLength":80,"minLength":16,"pattern":"^[A-Za-z0-9_-]+$","title":"Request Id"},"wallet":{"type":"string","maxLength":44,"minLength":32,"title":"Wallet"},"input_mint":{"type":"string","maxLength":44,"minLength":3,"title":"Input Mint"},"output_mint":{"type":"string","maxLength":44,"minLength":3,"title":"Output Mint"},"amount":{"type":"string","pattern":"^[1-9][0-9]{0,19}$","title":"Amount","description":"Exact input in integer atomic units, encoded as a JSON string."},"slippage_bps":{"type":"integer","maximum":10000.0,"minimum":0.0,"title":"Slippage Bps","description":"100 bps = 1%. Explicitly chosen by the signer."},"tip_lamports":{"type":"integer","maximum":1000000000.0,"minimum":2000000.0,"title":"Tip Lamports","default":2000000},"max_priority_fee_lamports":{"type":"integer","maximum":100000000.0,"minimum":0.0,"title":"Max Priority Fee Lamports","default":1000000}},"additionalProperties":false,"type":"object","required":["request_id","wallet","input_mint","output_mint","amount","slippage_bps"],"title":"SwapBuild"},"SwapSubmit":{"properties":{"signed_transaction_base64":{"type":"string","maxLength":1800,"minLength":100,"title":"Signed Transaction Base64"}},"additionalProperties":false,"type":"object","required":["signed_transaction_base64"],"title":"SwapSubmit"},"TradeQuery":{"properties":{"mints":{"items":{"type":"string"},"type":"array","maxItems":100,"title":"Mints"},"wallets":{"items":{"type":"string"},"type":"array","maxItems":100,"title":"Wallets"},"dexes":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Dexes"},"side":{"anyOf":[{"type":"string","pattern":"^(buy|sell)$"},{"type":"null"}],"title":"Side"},"min_sol":{"type":"number","minimum":0.0,"title":"Min Sol","default":0},"after":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"After"},"limit":{"type":"integer","maximum":500.0,"minimum":1.0,"title":"Limit","default":100}},"type":"object","title":"TradeQuery"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WalletRequest":{"properties":{"wallet":{"type":"string","maxLength":44,"minLength":32,"title":"Wallet"}},"type":"object","required":["wallet"],"title":"WalletRequest"}},"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"PumpView API key"}}},"servers":[{"url":"https://api.pumpview.fun"}],"externalDocs":{"url":"https://pumpview.fun/developers/quickstart","description":"Authentication, WSS, MCP and USDC payments"}}